<!]!) Ba!lantine/31594,'$9.95 in USA • $12.95 in Canada 



User's Handbook 















mm 



The only manual you'll ever need- 
from the moment you plug in your computer 
through set-up, operation, maintenance, 

and programming 

Weber Systems, Inc. Staff 






Apple lie® 
User's Handbook 




Apple lie® 
USER'S HANDBOOK 



Weber Systems Inc. Staff 



Ballantine Books • New York 




This book is available to organizations for special use. 

For further information, direct your inquiries to: 

Ballantine Books 

Special Sales Department 

201 East 50th Street 

New York, New York 10022 



Apple lie® User's Handbook 

Copyright © 1983 by Weber Systems, Inc. 

All rights reserved under International and Pan-American Copy- 
right Conventions. Published in the United States by Ballantine 
Books, a division of Random House, Inc., New York, and 
simultaneously in Canada by Random House of Canada Limited, 
Toronto. This is a fully revised edition of User's Handbook to the 
Apple lie Personal Computer®, originally published by Weber 
Systems, Inc. 



Apple lie is a trademark of Apple Computer Corporation. This book has been 
neither authorized nor endorsed by Apple Computer Corporation. 

Apple lie®, Apple DOS®, Applesoft BASIC®, and Integer BASIC® are trademarks 
of Apple Computer Corporation. 



Library of Congress Catalog Card Number: 83-91223 
ISBN 345-31594-4 

Manufactured in the United States of America 



First Ballantine Books Edition: April 1984 
10 987654321 




CONTENTS 



1. INTRODUCTION TO THE APPLE lie 11 

History of the Apple II 11. History or the Apple lie 11. Typical Apple 
Me System 12. Inside the Apple lie 13. Main Board 13. Expansion Slots 
14. Auxiliary Slot 14. Rear Panel 15. Bits & Bytes 16. ROM & RAM 
16. Dynamic & Static RAM 17. Apple lie Power Supply 17. Apple lie 
Speaker 17. Apple Me Video Display 18. Monitor/TV Set Connection 
18. Apple Me Video Display Formats 20. Cassette Recorder 22. Apple 
Me Disk Drive 23. Hand Controls 24. Apple Me Controller Cards 
24. Communications 25. Software 25. Operating Systems 26. Lang- 
uage Translators 26. Applesoft BASIC 27. Integer BASIC 27. Other 
Languages 27. Applications Programs 27. 

2. APPLE lie INSTALLATION, TROUBLESHOOTING, AND OPERATION 29 

Introduction 29. Installation 29. Troubleshooting 29. Built-in Self 
Tests 31. Apple Me Operation 32. Apple Me Keyboard 33. Space Bar 
35. Shift 35. Caps Lock 35. Cursor Control Keys 35. ESC Key 36. 
Open Apple Key 36. Solid Apple Key 36. Reset Key 37. 

3. APPLE BASIC PROGRAMMING 39 

Introduction 39. Switching from Applesoft to Integer 39. Compiled & 
Interpreted Languages 40. Immediate & Program Modes 40. Line 
Numbers 41. NEW Command 42. END Statment 42. Executing a Pro- 
gram 43. Program Lines & Display Lines 43. Multiple Statement Pro- 
gram Lines 43. Listing a Program 44. Error Message 45. BASIC Pro- 
gram Editing 45. Applesoft BASIC Data Types 46. Strings 46. Numeric 
Data 47. Floating Decimal Point 47. Floating Point Numbers 48. 
Integer 48. Scientific Notation 49. Variables 50. BASIC Variables 50. 
BASIC Variable Names 51. Tables & Arrays 52. Expressions and Opera- 
tors 54. Compound Expressions and Order of Evaluation 55. Arith- 
metic Operations 56. Logical Operators 59. Applesoft BASIC State- 
ments 61. Remark Statements 62. Assignments 63. Outputting Data 
65. INPUT Statements 67. GET 69. FOR, NEXT Loops 69. Nested Loops 
71. Conditional Statements 71. Branching Statements 72. ON, GOTO 




Statement 73. Subroutines & GOSUB Statements 73. ON, GOSUB 
Statements 75. Applesoft BASIC Functions 75. String Concatenation 
76. ASCII 77. CHR$ & ASC Functions 77. PEEK & POKE 78. Stopping 
Program Execution 79. Control-C 79. END 79. STOP 80. RESET 80. 

4. APPLE BASIC REFERENCE GUIDE 81 

Introduction 81. ABS 82. AND 82. ASC 84. ATN 84. AUTO 85. CALL 
86. CHR$ 87. CLEAR 88. CLR 88. COLOR 89. CON 90. CONT 91. 

COS 92. DATA 92. DEF FN 93. DEL 94. DIM 95 DRAW 97. DSP 
98. END 99. EXP 100. FLASH 100. FOR.. .NEXT 101. FRE103. GET 104. 
GOSUB, RETURN 105. GOTO 106. GR 107. HCOLOR 107. HGR 108. 
HGR2 109. HIMEM 110. HLIN 111. HOME 112. HPLOT 112. HTAB 
113. IF. ..THEN 114. IN#115. INT116. INVERSE 116. INPUT117. LEFTS 
118. LEN 119. LET 120. LIST 120. LOAD 121. LOG 122. LOMEM 123. 
MAN 124. MIDS124. NEW125. NORMAL 126. NOT126. NOTRACE 
127. ON 128. ONERR GOTO 129. OR 131. PDL133. PEEK 133. PLOT 
134. POKE 135. POP 136. POS 138. PRINT 139. READ 140. RECALL 
141. REM 144. RESTORE 144. RESUME 145. RETURN 146. RIGHTS 
146. RND147. ROT 149. RUN 150. SAVE 150. SCALE 151. SCRN152. 

SGN 154. SHLOAD 155. SIN 155. SPC 156. SPEED 156. SQR 157. 
STOP 157. STORE 158. STR$ 158. TAB 159. TAN 161. TEXT 161. 
TRACE 161. USR 162. VAL 163. VUN 163. VTAB 164. WAIT 165. 
XDRAW 166. 

5. CASSETTE & DISK STORAGE WITH THE APPLE lie 169 

Introduction 169. Cassette Installation & Operation 169. Saving and 
Loading a Program on Cassette 170. Storing and Loading Data on 
Cassette 171. Apple Me Disk Storage 171. Types of Disks 171. Hard 
Disks 171. Floppy Diskettes 173. Tracks and Sectors 174. Hard and Soft 
Sectors 176. Single and Double Sided Diskettes 178. Single, Double, 
and Quad Density Diskettes 178. Diskette Write Protection 178. 
Diskette Handling Rules 179. Inserting and Removing a Diskette 
180. Disk Operating System 181. Disk II System 181. Installing the 
Disk II System 181. Booting DOS 185. Auto Start Boot 185. Booting 
from Integer or Applesoft BASIC 186. Booting from the Monitor 
186. Restoring DOS 187. Using 13-Sector Diskettes with the lie 187. 
Prompts 180. Error Message Format DOS Commands 189. Filenames 
190. Drive Specification 190. Slot Specification 191. Volume Specifi- 
cation 192. CATALOG 194. Track/Sector List 196. INIT 197. Master 
and Slave Diskettes 199. LOAD 202. SAVE 202. DELETE 203. RENAME 
203. LOCK 204. VERIFY 204. MON and NOMON 205. MAXFILES 
207. EXEC 208. Creating an EXEC File 209. BSAVE 210. BLOAD 210. 
BRUN211. Sequential and Random File Access 211. Opening Sequen- 
tial Files 214. Writing to Sequential Files 214. Reading Sequential Files 
216. Closing a Sequential File APPEND 218. POSITION 219. Storing 
Data in Disk Files 221. Opening and Closing a Random Access File 
223. Reading and Writing to Random Files 223. Byte Parameter 224. 

6. APPLE lie GRAPHICS 225 

Low Resolution Graphics 225. Commands 225. Uses of Low Resolu- 
tion Graphics 228. Charts 228. Writing a Game Program 229. High 
Resolution Graphics 232. Commands 232. Shape Table 235. Shape 




Table Directory 240. Saving a Shape Table 243. Using the Shape Table 
244. SCALE 244. ROT 244. DRAW 245. XDRAW 245. Programming 
with Shape Tables 246. 

7. THE SYSTEM MONITOR 249 

Introduction 249. Activating and De-activating the Monitor 249. 
Commanding the Monitor 251. Memory Examine 251. Memory 
Dump 252. Register Examine 253. Changing Memory 253. Changing 
Registers 255. Move Data 255. Comparing Blocks of Memory 256. 
Saving4nd Retrieving Data with the Cassette 259. Saving and Retriev- 
ing Data from Disk 260. Other Input/Output Commands 261. Mach- 
ine Language Programming 263. Mini-Assembler 263. Activating the 
Mini-Assembler 264. Entering the First Program Line 264. Entering 
Subsequent Program Lines 265. Returning to the Monitor 265. 
Converting Assembly Language Hex Codes 265. Executing a Machine 
Language Program 267. Creating a Custom Monitor Command 268. 
Look Up Section 269. 

8. THE 80-COLUMN BOARD 273 

Activating the 80-Column Board in BASIC 274. Deactivating the 80- 
Column Board 275. Selecting 40 or 80 Columns While the Board is 
Active 276. Moving the Cursor 277. Editing Functions that Clear Parts 
of the Display 278. Scrolling the Display 279. Use of Control Codes 
279. BASIC Support of the 80-Column Board 281. Tabbing 281. Use of 
INVERSE, FLASH, and HOME 282. Uppercase — Restrict Mode 282. 



Appendix A. Applesoft BASIC Reserved Words & Tokens 285 

Appendix B. Integer BASIC Reserved Words 286 

Appendix C. DOS Reserved Words 286 

Appendix D. Applesoft BASIC Error Messages 287 

Appendix E. Integer BASIC Error Messages 290 

Appendix F. DOS Error Messages 292 

Appendix G. ASCII Character Set 295 

Appendix H. Apple lie Printer Usage 299 

Appendix I. Monitor Subroutines 301 

Appendix J. System Monitor Files 308 

Index 311 




INTRODUCTION 



The Apple lie User's Handbook is meant to serve as a tutorial as 
well as an ongoing reference guide to the Apple lie personal 
computer. The latest features of the Apple lie are discussed in 
detail including the 80 column card and the new lie keyboard. 

Chapter 1 of this book is intended to serve as an introduction to 
the lie. The system board, expansion slots, speaker, video dis- 
play, cassette recorder, disk drive, and BASIC interpreter are all 
discussed in this chapter. Terms basic to computing such as 
RAM, ROM, byte, bit, software, modem, operating sytem, inter- 
preter, compiler, and assembler are all defined in Chapter 1. 

Chapter 2 describes Apple lie installation, operation, and trou- 
bleshooting. Keyboard usage is discussed in detail in this 
chapter. 

Chapter 3 is meant to serve as tutorial on Applesoft and Integer 
BASIC programming on the lie. Topics such as BASIC start-up, 
switching from Applesoft to Integer, constants, variables, strings, 
arrays, operators, loops, functions, conditional statements, and 
branching statements are discussed in detail. Chapter 3 assumes 
the user has some familiarity with BASIC programming and is not 
meant to serve as an introductory guide to programming for the 
first-time user. 




Chapter 4 serves as a detailed reference guide to each of the 
various commands and functions available in both Integer and 
Applesoft BASIC. 

Chapter 5 includes a detailed discussion of data storage on 
cassette or diskette with the Apple lie. Each of the DOS 3.3 
commands are discussed in detail. Files and file handling are also 
discussed. 

Chapter 6 includes a detailed discussion of programming gra- 
phics on the Apple lie. 

Chapter 7 describes the usage of the lie's system monitor and 
mini-assembler. 

Chapter 8 discusses the usage of the lie's optional 80-column 
board. 

The Apple lie User's Handbook includes nine useful appendices. 
These detail the various Applesoft, Integer, and DOS reserved 
words and error messages, the ASCI I code set, printer usage with 
the lie, and the various monitor subroutines. 




CHAPTER 1. INTRODUCTION 
TO THE APPLE lie. 



HISTORY OF THE APPLE II 

When the Apple II computer was first introduced in the summer 
of 1977, it was one of the first fully assembled microcomputers 
available, the Apple II was designed by Steven Jobs and Steven 
Wosniak in a garage in Los Altos, California. 

From this humble beginning, the Apple II has evolved into a 
complete line of microcomputers, peripherals, and software. 
Apple computers can be found in homes, offices, small 
businesses, and factories throughout the world. Apple 
Computer, Inc. has grown into a multi-million dollar, multi- 
national firm in just a few short years. 

HISTORY OF THE APPLE lie 

The Apple lie was introduced in the spring of 1983. The lie is a 
redesigned version of the Apple II. The lie contains 64K of RAM, 
an expanded keyboard with 63 keys that can output both upper 
and lower case characters, an optional 80-column display and a 
6502B CPU (a high-speed version of the original 6502), 

The Apple lie includes both Applesoft and Integer BASIC. 
Applesoft BASIC is included in the ROM, and Integer is loaded 
from the System Master diskette. 

The lie uses the same Disk II drive used with the earlier Apple II 
models. DOS version 3.3 is used with the lie. 



* Although this book is dedicated to the Apple lie, the majority of the concepts 
apply to the Apple II as well. 
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TYPICAL APPLE lie SYSTEM 

A typical Apple Me system is depicted in Illustration 1-1. Your 
Apple lie system may not include the exact components 
pictured in Illustration 1-1. However, every Apple lie system 
must include at least two of the components shown in Illustration 
1-1— the Apple lie computer and a monitor or television set. 

We will discuss the Apple lie first, followed by the various 
peripherals that can be connected to this basic Apple lie system. 
These peripherals include a monitor or TV set, cassette recorder, 
Apple lie Disk Drive, printers, and the various Apple controllers 
or cards. 



Illustration 1-1. Typical Apple He System 
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Inside the Apple lie 

The Apple lie consists of the 6502B microprocessor, RAM 
memory, ROM memory, slots for the connection of controller 
cards, a power supply, a speaker, game I/O connectors, a video 
connector, a cassette interface, and a keyboard all enclosed in a 
protective case. The inside of the Apple lie is shown in 
Illustration 1-2. 

Main Board 

Once you have ppened your Apple lie you will notice a large 
green printed circuit board at the bottom of the open com- 
partment. This board is known as the main board. The main 
board contains the various 1C chips and components that control 
the Apple lie. 

Illustration 1-2. Inside of the Apple lie 



1. Internal Power-On Light 2. Expansion Slots 3. 6502B Microprocesspor 4. 
Power Supply 5. Auxiliary Slot with 80 Column Board 6. Memory 7. Speaker 
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Perhaps the most important component on the main board is the 
6502B microprocessor. As shown in Illustration 1-2, the 6502B 
microprocessor is located in the center of the main board just 
below the seven slots. The 6502B is a high speed version of its 
predecessor, the 6502. The 6502 was used in the Apple II and II 
Plus. The 6502B can address 64K of RAM. However, the lie has 
incorporated special memory banking and switching techniques 
to allow more than 64K to be addressed. 

Several other important components of the main board are 
depicted in Illustration 1-2. These include an AYf3600 integrated 
circuit and a ROM chip that are used to encode the keyboard 
characters. The main board also includes two ROM chips that 
contain the Applesoft BASIC interpreter. 

The main board contains an MMU integrated circuit which 
controls memory addresses within the lie, and an IOU integrated 
circuit which controls the built-in input/output features of the 
lie. 

Eight RAM 1C chips are located at the bottom right of the main 
board. These supply the lie with 64K of RAM. 

Expansion Slots 

Towards the rear of the main board are located seven expansion 
slots. These slots allow additional hardware devices to be 
installed with the Apple lie. For example, an expansion card is 
available that enables the lie to run the CP/M operating system. 
Also, controller cards must be installed in these slots to enable a 
printer or disk drive to be used with the lie. 

Notice that these seven slots are numbered from 1 through 7. In 
the Apple II, eight slots (numbered 0 through 7) were available. 

Auxiliary Slot 

Notice the large expansion slot located on the left side of the 
main board. This is known as the auxiliary slot. If your lie 
contains the 80-column text option, the 80 column text card will 
be installed in this slot. 
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Rear Panel 

The bottom left-side of the rear panel of the Apple lie (see 
Illustration 1-3) contains a 9-pin D-connect6r for the installation 
of hand controls, two phone jacks for the installation of a 
cassette recorder, and an RCA type jack for the installation of a 
video monitor. 

The bottom right-hand side of the lie's rear panel contains the 
AC cord socket and an on/off switch. Both of these are 
connected to the power supply. 

Finally, note the rectangular openings along the lie's rear panel. 
These openings are numbered from 1-12. When the lie is 
connected to one or more peripheral devices using an interface 
card, that card's connector is attached to the proper opening. 
Openings 1 through 4 are used for 19-pin connections; 5, 6, 8 and 
9 are used for 9-pin connections; and 7, 10, 11, and 12 are used 
for 25-pin connections. 

Illustration 1-3. Apple lie Rear Panel 




1. Video Monitor Jack 2. Cassette Recorder Input/Output Jacks 3. 
9-pin D-Connector 4. Rectangular Openings 5. AC Cord Socket 6. 
On/Off Switch. 
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Bits & Bytes 

Microprocessor logic is based upon the bit. A bit is the basis of all 
information storage within the computer. A bit consists of a 
simple switch that can consist of either of the two binary states, 
on or off. 

Bits are often separated into groups of eight. These groups of 8 
bits are known as a byte. A byte is required to represent a single 
character (i.e. letter, number, or symbol). Generally, bytes are 
processed by the computer in groups of 2. 

Most of the 8-bit microprocessors can only address (or work 
directly with) 65,535 (64K) bytes at any one time. Even though this 
number appears large, a 30 page document would fill this 
memory area. The Apple lie uses an 8 bit microprocessor. 
However, due to the usage of special memory banking and 
switching techniques, the lie can address over 64K of memory. 

Most 16-bit microprocessors can address from 65535 to 16 
million bytes of memory. Moreover, 16 bit microprocessors 
process data at a speed from 2 to TO times faster that 8-bit 
microprocessors. The IBM Personal Computer is an example of a 
computer that uses a 16 bit microprocessor. 

ROM and RAM 

ROM stands for Read-Only Memory. ROM will hold the data 
stored in it permanently. If the power to the Apple is shut off, the 
information stored in ROM will remain there. As previously 
mentioned, the Apple's BASIC language interpreter is stored in 
ROM. 

RAM stands for Random Access Memory*. Any data stored in 
RAM is lost when the Apple’s power is shut off. When data is 



* Random Access Memory is a somewhat misleading term to 
describe RAM, as most memory (including ROM) is randomly 
accessed. 
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loaded from a tape cassette, a disk drive, or the keyboard, it is 
stored in RAM. For example, when a program is loaded from the 

Apple Disk II, it will be stored in RAM. 

) 

Dynamic and Static RAM 

There are two different types of RAM memory; dynamic RAM 
and static RAM. Dynamic RAM can only hold the data it is storing 
for a few milliseconds. Therefore, any data being stored in 
dynamic RAM must constantly be rewritten or refreshed. This 
dynamic RAM refresh function must be a part of the support 
logic when the dynamic RAM memory is designed. 

Static RAM is more expensive than dynamic RAM. However, 
once data has been written into static RAM, it will be retained as 
long as power is supplied. 

Apple lie Power Supply 

The Apple lie's power supply is located on the left side of the 
inside of the unit as shown in Illustration 1-2. The power supply 
will supply four voltages: +5v, -5v, +12.0v, and -12v. 

The Apple’s main power cord plugs into the power supply on the 
back of the Apple. The Apple’s power-on switch is also located 
on the back of the power supply. This is pictured in Illustration 
1-3. 

Some Apple’s have a power supply with a switch which allows 
the user to select either 110 or 220 volts. 

Apple lie Speaker 

As pictured in Illustration 1-2, the Apple lie’s speaker is located 
inside the case on the lower left hand side. The speaker is 
connected to the Apple so that a program can be used to create 
sounds on it. 

The Apple lie’s speaker is controlled by a soft switch. Soft 
switches have two states (ex. in/out; on/off; text/graphics). By 
addressing a special memory location associated with the soft 
switch, a program can change the state of the switch. 
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It is unimportant what data values are actually read from or 
written into the memory address associated with a soft switch. It 
is the reference to that address that throws the switch. The data 
written to or read from the location has no effect. 

Machine language programs should reference the hexadecimal 
value for the memory address associated with the soft switch. 
BASIC programs should use a read operation to the decimal 
value for the memory address associated with the soft switch. A 
write operation causes such a short pulse that the speaker will 
not emit a sound. 

The memory address for the soft switch associated with the 
speaker is 49200 or hexadecimal C030H. Whenever this address is 
referenced in a program, the speaker will emit a small click. By 
continually referencing this address, the speaker will generate a 
continuous tone. 

APPLE lie VIDEO DISPLAY 
Monitor/TV Set Connection 

The Apple lie can either use a monitor or a regular TV set for 
video output. The connection between the lie and a monitor is 
simple. Merely use a video cable to connect the video port on the 
rear of the lie to the video input port on the monitor. This 
connection is depicted in Illustration 1-4. 

The connection between the lie and a TV set is somewhat more 
complicated due to the fact that the lie's video signal must be 
converted to a signal that can be comprehended by the TV set. A 
device known as an RF modulator must be installed in the lie in 
order to convert the lie's video signal. The RF modulator is 
generally connected to a group of four Molex-type pins on the 
rear right-hand side of the main board. 

A switch box is also generally connected to the VHF terminals of 
the TV set's antenna box. This switch box enables the TV set to be 
operated normally in one setting; while in the second setting, it 
serves as the lie's video output device. The installation of the TV 
switch box is depicted in Illustration 1-5. 
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Modulators are also available which can be connected directly 
to the VHF terminals in the TV set’s antenna. If this type of 
modulator is directly connected to the TV set, a cable can be run 
from the video out port on the rear of the lie to the modulator to 
make the proper connection. 



Illustration 1-4. Apple lle/Monitor Connection 




1. Video Cable Connector 



Illustration 1-5. Apple lle/TV Set Connection 
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Apple lie Video Display Formats 

The lie can display the following four types of video output: 
40-column text mode. 

80-column text mode (with optional 80-column card). 
Low-resolution graphics (40 x 48 with 16 colors). 
High-resolution graphics (280 x 192 with 6 colors). 

In the text mode, the lie has the capability to display 24 lines with 
40 or 80 columns per line. The characters in the 80 column mode 
are only half as wide as those in the 40 column mode. For this 
reason, the 80 column text mode generally cannot be used with a 
regular color or B&W television set as the resultant output is so 
blurred that it is unreadable. A high-resolution video monitor 
must be used to obtain clear output in the 80-column text mode. 

In the text mode, any of the 96 ASCII characters can bedisplayed 
including lower and upper-case letters numbers, and symbols. 
The text characters are generally displayed as white dots on a 
black background. However, text characters can also be display- 
ed as black characters on a white background. This type of 
display is known as the inverse format. 

Each individual character is displayed on a matrix seven dots 
wide by eight dots high. The character itself is only five dots 
wide. This leaves one blank dot on either side of the character. 
Therefore, a total of two rows of blank dots are allowed between 
characters. With the exception of lowercase characters with 
descenders characters are created seven dots high. This leaves 
one blank line of dots between characters. 

Two different character sets are available in the text mode: the 
primary character set and the alternative character set. The 
characters themselves are identical in each character set. How- 
ever, the format in which the characters are displayed differs. 
The following formats are available: 

normal - white dots on black background. 
inverse - black dots on a white background. 
flashing - alternating between normal and inverse. 
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In the primary character set, the lie can display uppercase 
characters in either the normal, inverse or flashing formats. 
Lowercase letters can only be displayed in the normal format. 

In the alternative character set, the flashing format for uppercase 
and lowercase letters is unavailable. However, the normal and 
inverse formats for both upper and lowercase letters is available. 
The alternative character set is used when the 80-column card is 
active. 

In low resolution graphics, the lie can display 1920 blocks of data 
within an array that measures 48 blocks high by 40 blocks wide. 
Each block can be assigned any one of the following 16 different 
colors available with low resolution graphics. 



Black 
Magenta 
Dark Blue 
Purple 
Dark Green 
Grey 1 

Medium Blue 
Light Blue 



Brown 
Orange 
Grey 2 
Pink 

Light Green 
Yellow 
Aquamarine 
White 



No empty space exists between blocks. Therefore, if a group of 
several adjacent blocks are assigned the same color, they will 
appear as a single mass. 



High resolution graphics consists of 53,760 dots in 280 dot wide 
by 192 dot high array. The dots used in high resolution graphics 
are the same size as the dots used to make up characters in the 
text mode. 



The following six colors are available in the high resolution 
graphics mode: 

black blue 

white green 

orange purple 

Every dot in high resolution graphics can either be black, white, 
or one of the colors. However, every color is not available for 
every dot in high resolution graphics. 
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In either low or high resolution graphics, the user can include 4 
lines of text at the bottom of the display. In low resolution 
graphics, these 4 lines of text replace the final 8 rows of blocks. In 
high resolution graphics, they replace the lower 32 rows of dots. 
These display modes which contain bbfh text and graphics 
characters are known as mixed modes. 

Cassette Recorder 

Your Apple lie can be connected to a cassette recorder via the 
cassette interface. The cassette recorder can be used to store 
programs or data transferred from RAM. These programs or data 
later can be transferred back into RAM. 

The cassette interface jacks are located on the rear of the lie. The 
cassette interface jacks can be used to connect the Apple to a 
standard cassette tape recorder. The tape recorder can be used 
as a data storage device for the Apple. 

The two cassette interface jacks are labeled with illustrations. 
The output jack is labeled with a picture of an arrow pointing 
towards a cassette. The input jack is labeled with a picture of an 
arrow coming from a cassette. 

The cassette input jack should be connected to the cassette 
recorder's earphone or monitor output jacks. The input jack will 
listen to the tones on the cassette tape, translate those tones into 
data, and then store them in memory. 

The OUT or output jack should be connected to the cassette 
recorder's microphone input jack. The output jack is connected 
to a soft switch just as the Apple speaker is. The cassette's output 
jack soft switch memory address is 49184 (-16352 Integer BASIC). 
By referencing this address, the voltage at the output jack will be 
varied, causing a tone to be produced on the tape. By altering 
the pitch and duration of this tone, data can be recorded on the 
cassette tape. 

An Apple lle/cassette recorder hook up is pictured in Illustra- 
tion 1-6. The cassette recorder will be covered in more detail in 
Chapter 5. 
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Illustration 1-6. Apple lie Hookup to Cassette Recorder 




1. Output Jack 2. Input Jack 



Apple II Disk Drive 

A floppy disk system is a much more efficient means of data 
storage than is a cassette recorder system. The name of the 
floppy disk system used by the Apple lie is the Disk II. The Disk II 
system includes a disk drive, disk controller card, and a cable 
used to connect the disk controller card to the disk drive, (see 
Illustrations 5-8 and 5-9). 

The Disk ll's controller card is installed in one of the expansion 
slots in the lie's main board. The Disk M's operation and 
programming will be discussed in detail in Chapter 5. 

Printers 

A printer can be connected to the Apple lie either via a serial 
interface card or a parallel interface card. The type of card used 
depends on whether the printer being connected is a serial or 
parallel device. 
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Data may be sent from the computer to the receiving device 
(printer or video display) in two different manners; serial and 
parallel. In parallel communications, the 8 bits representing a 
character are all sent at one time to the receiving device. In serial 
communications, each of the 8 bits are sent one at a time to the 
receiving device. Generally, printers use parallel communication. 

A wide range of printers are available for use with the Apple lie. 
The printer interface card can be installed in slots 1-7 in the main 
board. Generally, openings 7, 10, 11, or 12 on the rear of the lie 
are used for the installation. 

The use a printer with the Apple lie will be covered in greater 
detail in Appendix H. 

Hand Controls 

The 9-pin conqector in the lie’s rear panel is generally used for 
the installation of hand controls such as game paddles, a joystick, 
etc. 

A Game I/O Connector is also available on the main board (see 
Illustration 1-2). Controllers using a 16-pin connection can be 
attached via the connector. 

Apple lie Controller Cards 

Earlier in this chapter, we mentioned the seven plug-in slots on 
the Apple’s main board. The slots were designed to accept 
special circuit boards known as controllers or cards. 

Cards are available for a number of different applications. For 
example as we mentioned previously, a parallel or serial 
communications card is required to install a printer on your 
Apple lie. Controller cards are required for installing a disk drive 
with you Apple lie. 
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A number of other cards are also available for the Apple lie. 
These include communications cards which allow you to con- 
nect you Apple lie to a modem, which in turn allows your Apple 
to accept data transmitted over telephone lines. Cards are also 
available which convert digital signals to analog and vice versa. 
Finally, cards are also available that allow the Apple lie to run 
under an operating system completely different from Apple 
DOS known as CP/M 



Communications 

The Apple lie can communicate with another Apple computer 
located a few miles away or a few thousand miles away. A device 
known as a modem, your telephone, and telephone lines allow 
this communication to take place. 

A modem converts signals generated by the lie into signals 
which can be transmitted over telephone lines. A modem will 
also reconvert the signals transmitted over phone lines back into 
a signal which can be understood by the lie. 

Generally, a modem is connected to the lie using a Super Serial 
Card. Once the Super Serial Card has been installed (in slots 1-7), 
connect the card to the modem. Then, connect the modem to 
your telephone. 

A modem allows the user to access one of the many available 
information services. Examples of these information services include 
CompuServe, The Source, and the Dow Jones News and Quotes 
service. A modem also allows communications with other 
Apples. 

SOFTWARE 

Software can be described as the instructions or programs that 
cause the computer to operate. Several different classifications 
of software exist for the performance of different functions. 
These can be classified as operating systems, languages, and 
applications programs. 
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Operating Systems 

An operating system can be defined as a group of programs 
which manage the overall operation of the computer. The 
operating system performs system operations such as controlling 
data input/output, memory assignments, etc. 

The standard operating system supplied with the lie with a disk 
drive is DOS 3.3. DOS stands for disk operating system. 

There are several other operating systems available for the lie. 
The most well-known of these is CP/M. To install CP/M, a Z80 
peripheral card must be installed in slot 7 of the lie. The Z80 card 
contains a Z80 microprocessor. The Z80 is necessary to run 
CP/M. 

Language Translators ^ 

Programs are generally written in a high-level language that is 
different from the instructions the computer uses. A program 
known as a language translator must be used to translate the 
high-level language into a form that the computer can compre- 
hend. 

There are three categories of language translators: interpreters, 
compilers, and assemblers. 

A compiled language program consists of the source code and 
the compiled code. The source code consists of the program 
statements in their original form. For example, the following is a 
line of source code from a program written in the CBASIC 
compiled language: 

100 INPUT “ENTER TODAY'S DATE:"; DATE.1 

The source code is processed by a program known as a compiler 
into the compiled code. The compiled code is very similar to the 
machine language used by the microprocessor. The compiled 
code is the code actually used when a compiled program is run. 
A program known as a run-time monitor is used to run the 
compiled program. { 
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An interpreted language consists of only the source code. The 
source code is translated line-by-line directly into machine 
language instructions. The Applesoft BASIC language that is 
standard on the lie is an interpreted language. 

An assembler translates program instructions one by one into 
instructions that the CPU can comprehend. 

Applesoft BASIC 

The most widely used language on the lie is Applesoft BASIC. 
Applesoft BASIC is resident in ROM in the lie’s main board. 
Applesoft BASIC is a floating point language. This allows it to 
process both very large and very small numbers. 

Integer BASIC 

Integer BASIC is automatically loaded into RAM when the 
system is booted from the DOS 3.3 System Master diskette. 
Unlike Applesoft BASIC, Integer BASIC does not have the 
capability to process numbers with decimal portions. 

Other Languages 

A number of other languages are available for the lie including 
PASCAL, FORTRAN, Logo, PILOT, and 6502 Assembly Language. 

Applications Programs 

Applications programs are those written to accomplish a specific 
task. Examples of applications programs include word proces- 
sing programs, electronic spread sheets, data base systems, and 
accounting programs. Generally, applications programs are 
stored on cassette or diskette and are transferred into RAM, 
where the program is available to the computer. 

Some of the more popular applications programs available for 
the lie include: 
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Database: 



Electronic 

Spreadsheets: 

Word 

Processors: 



PFS: The Personal Filing System 
DB Master 
Quick File II 

Visicalc 
Plan 80 

Wordstar 
Apple Writer 




CHAPTER 2. APPLE lie INSTALLATION, 
TROUBLESHOOTING, AND OPERATION 



INTRODUCTION 

In this chapter, we will explain in detail steps involved in 
installing the Apple lie. We will then outline a few trouble- 
shooting hints for the lie. Finally, we will discuss lie operation. 

INSTALLATION 

The first step in installing the lie is to position the console on a 
flat desk or table near a household AC outlet. 

The next step is to connect the AC power cable to the power 
cord outlet on the rear of the I le. Then, connect the other end of 
the AC power cable to a household outlet. Turn the power 
switch (on the lie’s rear panel) to the on position. If the 
connection was properly made, the lie should power on. 

You are now ready to install a monitor or TV set as described in 
Chapter 1. Be certain to turn off the lie’s power switch and 
unplug the power cord prior to making this connection. 

TROUBLESHOOTING 

Table 2-1 contains a number of hints that may be able to help 
you isolate any problems should your lie not function properly. 
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Table 2-1. Apple lie Troubleshooting Hints 



Symptoms of 
Problem 


Possible Solution 


Apple lie powers 
on, but cursor does 
not appear. 


Be sure that the video display is 
plugged in and turned on. 
Check the display's contrast and 
brightness controls. If the pre- 
ceding solutions do not solve 
the problem, disconnect all peri- 
pherals from the lie except the 
display and run the lie's selftests 
(explained later). 


Apple lie will not 
power on. 


Check to be sure that the power 
cord is properly connected to 
both the lie and to the wall 
outlet. Be sure that the wall 
outlet is receiving power. 


Program will not 
load from cassette 
recorder. 


Check the cassette tape to be 
sure that it has been rewound. 
Also, check the cable connec- 
tion between the recorder and 
the lie. Check the volume set- 
ting on the cassette recorder. 
Finally, certain recorders do not 
work well with the lie. If you 
suspect this to be the problem, 
try another recorder. 


SYNTAX ERROR 
message. 


This is generally due to the incor- 
rect entry of an Applesoft or 
Integer BASIC command. Be 
careful not to use lower-case 
characters in reserved words. 
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Table 2-1. Apple lie Troubleshooting Hints (con’t.) 



Symptoms of 
Problem 


Possible Solution 


Must Boot From Slot 
6 message. 


The PASCAL operating system 
must be booted with the system 
diskette in drive 1 — which must 
be attached via slot 6. If nec- 
essary, reinstall the disk control- 
ler in slot 6. 


Disk drive's in use 
light remains on. 


Check to be certain that the 
drive's door is closed. Try pres- 
sing Ctrl-Reset to stop the 
drive. 


Drive emits weak 
sounds while 
rotating. 


If a card is installed in the auxil- 
iary slot, the disk controller card 
should not be installed in slot 3. 
Reinstall the disk controller 
card in a different slot. 


Disk drive 
occasionally rattles 
during operation. 


Be sure the diskette being used 
was properly formatted. Be cer- 
tain that the disk was properly 
inserted into the drive. 



Built-In Self Tests 



The lie contains a series of built-in self-tests designed to evaluate 
the operation of the unit’s internal circuitry. These tests do not 
check the operation of any devices attached to the lie. 

To begin the self-test, press the Solid Apple and Ctrl-Reset keys 
simultaneously. Release Ctrl-Reset first followed by the Solid 
Apple key. 

The self-tests require approximately 20 seconds of execution 
time. During the self-tests, patterns will move across the screen. 
Upon successful completion of the tests, the following message 
should appear on the screen: 
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KERNEL ON 

If any other message appears, the lie requires servicing. 

APPLE lie OPERATION 



The lie is started up by booting DOS (abbreviation for disk 
operating system) from the System Master diskette. The System 
Master diskette is included with your Apple lie Disk II drive and 
is labeled “DOS 3.3 System Master/' You can either use that 
diskette or a copy to start up the lie. It is recommended that once 
you learn diskette copying procedures (see Chapter 5), you use a 
copy of the System Master diskette for everyday lie operations. 

To insert the diskette, open the drive door to drive 1. The System 
Master must be inserted in drive 1. This is the drive attached to 
the controller card in slot 6. Insert the System Master diskette 
into the drive with its label facing up. The label side should be 
nearest your hand and the side of the diskette with the oval slot 
should be inserted into the drive. Once the diskette is in place, 
close the drive door. 

Next, power on the monitor connected to the lie. Then, power 
on the lie itself by pressing the toggle switch located at the rear 
of the unit next to where the power cord plugs into the machine. 
The lie will beep, the disk drive will spin, and the drive light will 
blink on and off as DOS is loaded. The green power light to the 
left of the open Apple key will also be lighted and the display 
depicted on page 33 will appear on the monitor. 

The symbol ] is the Applesoft BASIC prompt. When the symbol 
appears, the user can enter either Applesoft BASIC or DOS 
commands. 
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Apple lie Keyboard 

The Apple lie keyboard is depicted in Illustration 2-1. The Apple 
lie keyboard is arranged differently than the keyboard on the 
Apple II or II Plus. 

First of all, the lie contains 12 additional keys. These new 



Illustration 2-1. Apple lie Keyboard 
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keys include: 



DELETE 

TAB 

CAPS LOCK 

I 

I 

Open Apple Function Key 
Solid Apple Function Key 
Special Character Keys 

The REPT key on the Apple II and II Plus has been replaced with 
an auto-repeat feature in the lie. The auto-repeat feature causes 
all printing characters to automatically repeat if the key is held 
down longer than a second or two. 

The Apple lie keyboard allows the user to send any one of 128 
ASCI I characters to the computer. Of these 128 characters, 96 are 
printing characters. That is, they will be echoed on the screen 
when entered at the keyboard. The printing characters include: 

26 lowercase letters 

26 uppercase letters (output with caps lock or shift 
depressed) 

10 numerics 
34 special characters 

vi 

The non-printing characters consist of the 32 control characters. 
The control characters are output by simultaneously pressing the 
Control key with a second key (generally a letter). 

Several of the control codes can also be output via special keys 
on the lie keyboard. For instance, the same control code that is 
output by Ctrl-M is also output by the Return key. Therefore, the 
ASCII return code (ASCI1 13 decimal) can be produced in two 
separate ways. 

Asa general rule, the printing characters are used for outputting 
information, while the control characters are used to instruct the 
system to perform some function. 
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We will discuss the more important keys on the lie keyboard in 
more detail in the following sections. 

Space Bar 

The space bar (located at the bottom of the lie keyboard) 
generates the space character (ASCII 32 decimal). Be certain to 
include the space character where specified in DOS or BASIC 
commands. 

Shift 

The Shift key causes the uppercase character to be output for the 
key being pressed. There are two Shift keys on the lie keyboard, 
one on the left and one on the right side of the keyboard. 

Caps Lock 

The Caps Lock key is located just below the Shift key on the 
left-hand side of the keyboard. When the Caps Lock key is on 
(depressed), all alphabetic keys will be output as uppercase 
characters. No other keys will be affected. This allows the user to 
output only uppercase letters, while still being able to enter 
numbers. 

Once Caps Lock is on (depressed), it can be turned off by 
pressing the key a second time. When the key is pressed, it clicks 
back into the up position. 

Cursor Control Keys 

The cursor control keys can be used to move the cursor around 
the screen. The cursor control keys are described below: 



Left-Arrow Moves the cursor one position 

to the left. 

Right-Arrow Moves the cursor one posi- 

tion to the right. 
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Down-Arrow 



Moves the cursor down by 
one line. 



Up-Arrow 



Tab 



Return 



Moves the cursor up by one 
line. (ESC key must first be 
pressed.) 

Moves the cursor to the next 
tab setting. Tabs generally are 
set after every eight char- 
acters. This key only functions 
with certain programs (gener- 
ally word processing soft- 
ware). 

Moves the cursor to the be- 
ginning of the next line. 



ESC Key 

The ESC key outputs the control code for ESC (ASCI 1 27 decimal). 
The ESC key is often used to either place the computer in the 
escape mode or to enter an escape sequence. 

Open Apple Key 

The Open Apple key appears to the left of the space bar. The 
Open Apple key can be used to restart the lie when it has already 
been powered on. This is accomplished by pressing the Open 
Apple key simultaneously with Ctrl-Reset. 

Pressing the Open Apple key also has the same effect as pressing 
the button on game controller #0. The Open Apple key can be 
used as an alternative to pressing the game controller. 

Solid Apple Key 

The Solid Apple key is located to the right of the space bar. The 
Solid Apple key when pressed simultaneously with Ctrl-Reset 
starts the Apple lie's built-in self-test. 

The Solid Apple key also has the same effect as pressing the 
button on game controller #1. 
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Reset Key 

The Reset key is located to the right of the Delete key on the right 
hand side of the lie keyboard. Pressing Ctrl-Reset causes 
execution of most lie programs to stop. 




CHAPTER 3 

APPLESOFT BASIC PROGRAMMING 



INTRODUCTION 

BASIC is the most widely used personal computer programming 
language with the Apple lie being no exception. The lie includes 
two different versions of BASIC; Applesoft and Integer. Apple- 
soft BASIC is contained in ROM and will be active when the lie is 
started up. Integer BASIC is loaded from the System Master 
diskette when DOS is booted. 

Applesoft BASIC is a floating point language. This allows 
Applesoft to handle numbers with decimal portions, as well as 
extremely large and small numbers expressed in decimal 
notation. 

Integer BASIC can only deal with integers. Obviously, Applesoft 
is a more practical version of BASIC then Integer. For this reason, 
our discussion of BASIC programming will be centered around 
Applesoft BASIC. 

Switching from Applesoft to Integer & Vise Versa 

As mentioned in the preceding section, Applesoft BASIC will be 
active when the He is started up. If you wish to switch to Integer 
BASIC, enter INT via the keyboard. The Integer BASIC prompt 
( =»■ ) will appear. 

'i 

If you wish to switch back to Applesoft BASIC, enter FP via the 
keyboard. The Applesoft BASIC prompt (]) will appear. 
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Compiled & Interpreted Languages 

The conversion from a high level language to machine language 
is either done with an interpreter or a compiler. A compiler is a 
program that converts an entire high level program to machine 
language. A compiler performs a complete translation of the set 
of instructions before the program is actually executed. An 
interpreter converts each instruction to machine language as the 
program is executed. 

A compiled language such as CBASIC executes programs very 
quickly. However, an interpreted language such as Applesoft 
BASIC is easier to use, because it does not need to be compiled. 
Unfortunately, interpreted languages require more time to 
execute because each instruction must be translated into 
machine language as the program proceeds. 

Immediate & Program Modes 

The immediate mode is also known as the direct or the calculator 
mode. In the immediate mode, most BASIC command entries 
result in the instructions being executed without delay. For 
example, if the following immediate mode line was entered: 

PRINT “JIM SMITH" 

the following would be displayed on the video screen: 

JIM SMITH 

In the program or indirect mode, the computer accepts program 
lines into memory, where they are stored for later execution. 
This stored program is executed when the appropriate 
command (generally RUN) is entered. 

Illustration 3-1 contains an example of the entry of a program in 
the program mode and its execution. 
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Illustration 3-1. Program Mode Entry & Execution 




] NEW 

] 10 PRINT “JIM SMITH” 

] 20 PRINT “1220 EUCLID AVE” 

] 30 PRINT “CLEVELAND, OH 44122" 

] 40 END 

j RUN 

JIM SMITH 

1220 EUCLID AVE 

CLEVELAND, OH 44122 

] 



V J 

Line Numbers 

In the program mode, program lines must begin with a line 
number. A line number is a one through five digit number 
entered at the beginning of a program line. The line number at 
the beginning of a program line is the only difference between it 
and an immediate mode line. 

No two line numbers can be the same. If the same line number is 
used more than once in a program, the line most recently 
entered will replace the original. 

The execution sequence of a BASIC program is determined by 
the value of its line number. The lowest line numbers will be 
executed first, followed by program lines with higher line 
numbers. Even if program lines are not arranged in sequential 
order, the Applesoft BASIC interpreter will place the lines in the 
correct order. 
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Adding program lines to a program stored in RAM is very easy. 
Just type in the line number followed by the program line. The 
line will be inserted in the program in the position indicated by 
its line number. For example, by adding the following line to the 
program in Illustration 3-1: 

35 PRINT "216-777-5579" 

the phone number for Jim Smith will be displayed on the line 
following his city, state, and zip. 

Program lines can be deleted by typing the line number to be 
deleted followed by Return. For example, the following entry: 

30 

would result in line 30 being deleted. 

Program lines can be changed by merely retyping the new line. 
The existing line in the lie’s memory will be replaced with the 
new line. For example, the following entry: 

10 PRINT “THOMAS HILL” 

would result in “THOMAS HILL” being output rather than “JIM 
SMITH” in the program Illustration 3-1. 

NEW Command 

You may have noticed the execution of the NEW command in 
Illustration 3-1. The NEW command is used to erase an old 
program from memory before a new one is typed in. 

The lie can only store one program in RAM^at any one time. If 
you attempt to enter a new program while another program is 
already stored in RAM, the new program will be merged with the 
existing program. 

END Statement 

Notice the last line in the program in Illustration 3-1. That line 
consists only of the line number plus the BASIC reserved word 
END. 
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The END statement identifies the end of a program, and instructs 
BASIC to return to the immediate mode. Obviously, the END 
statement should be the last line in your program. 

Actually, Applesoft BASIC does not require an END statement. 
When the program’s final statement is executed, it will end. 
However, it is good programming practice to end a BASIC 
program with the END statement. Integer BASIC does require an 
END statement. 

Executing a Program 

A program is executed in the program mode by entering the 
RUN command. This is shown in Illustration 3-1. Every time RUN 
is executed, the program will be re-executed. As previously discussed, 
in the immediate mode, each program line will be executed 
when the Return key is pressed. 

Program Lines & Display Lines 

A display line can be defined as one row on the video display. A 
program line is regarded by the BASIC interpreter as one line, 
regardless of the number of display lines it occupies on the 
screen. The end of a program line is signalled when the Return 
key is pressed. Program lines are generally limited to 255 
characters. 

Multiple Statement Program Lines 

A statement can be defined as an instruction to the computer. 
The terms statement and command are often used interchange- 
ably. Most programs consist of a large number of statements. 

The following are examples of statements: 

PRINT “TIM GREGORY" 

070 DIM A(15) 

100 C=2*B 
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Every statement in Applesoft BASIC must contain at least one key 
or reserved word. A keyword identifies the calculation, decision, 
input, or output function to be performed. The keywords are 
described individually in Chapter4 and are listed in alphabetical 
order in Appendices A and B. 

In addition to keywords, numeric constants, string constants, 
variables, and special symbols may appear in a BASIC statement. 
These are known as the statement parameters. 

Applesoft BASIC allows the user to place more than one 
statement on a single program line. Multiple statements must be 
separated with a colon (:). The following is an example of a 
multiple statement program line: 

10 A=B*7:PRINTB 



Listing a Program 

As mentioned earlier, the LIST command can be used to display 
program lines currently stored in RAM. Remember, if the NEW 
command is issued, the program in RAM will have been erased, 
and can no longer be displayed by LIST. 

LIST is used in the following configuration:* 

LIST [//ne 1 - line 2]** 

where line 1 is the line number of the first line to be listed, and 
line 2 is the line number of the last line to be listed. 



*ln this book, a standard format will be used to describe BASIC 
keyword configurations. The keyword will be displayed in our 
regular type style in upper case. Parameters will be displayed in 
our italic type style in lower case. Optional parameters will be 
enclosed in brackets. 

** This option is only available in Applesoft. A comma may be 
substituted for the hyphen. 
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LIST can be used without any parameters to list the entire 
program. LIST can also be used with a single line number to list 
just that program line. If LIST is used with the following format: 

LIST line 1- 

line 1 and all subsequent lines will be listed. 

If LIST is used as follows: 



LIST -line 2 

line 2 and all lines preceding it will be listed. 

In certain situations (especially when a long program is being 
listed, you may wish to cancel or temporarily halt a program 
listing. With the lie, you can cancel an Applesoft program listing 
by pressing Ctrl-C. 

A program listing can be stopped temporarily by pressing Ctrl-S 
and resumed by pressing the space bar. 

Error Messages 

When the lie encounters a statement with an error, an error 
message will be displayed. The error message will be displayed in 
the following formats: 

? SYNTAX ERROR -* — Applesoft BASIC 
***SYNTAX ERROR-* — Integer BASIC 

The various Applesoft and Integer BASIC error messages are 
described in Appendices D and E. 

BASIC PROGRAM EDITING 

In our discussion of the lie keyboard, we mentioned several of 
the keys used in editing. These include: 

— used to backspace the cursor. 

— ►used to move the cursor foward. 
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t used to move the cursor up. 

| used to move the cursor down. 

The following keys and key combinations can also be used in 
editing: 



Ctrl-X 


erases the current line. 


Esc-@ 


clears the display and homes the 




cursor. 


Esc-A or K 


moves the cursor to the right. 


Esc-B or J 


moves the cursor to the left. 


Esc-C or M 


moves the cursor down one row. 


Esc-D or 1 


moves the cursor up one row. 


Esc-E 


erases text from cursor to end of line. 


Esc-F 


erases text from cursor to end of text 
windows. 


Once Esc 1, J, K,or M 


has been pressed, the lie will be in the edit 



mode. In the edit mode, it will no longer be necessary to press 
Esc with I, J, K, or M to move the cursor. The cursor can be moved 
by pressing I, J, K, or M. The edit mode can be ended by pressing 
any key except I, J, K, M, Ctrl, or Shift. 

APPLESOFT BASIC DATA TYPES 

Data can be classified under two major categories: text and 
numeric. Text data consists of characters. These characters are 
generally used within strings. 

Examples of numeric data include: 

Integers 

Floating Point Numbers 
Scientific Notation 

Each of these data types will be discussed in the following 
sections. 

STRINGS 

A string consists of one or more characters enclosed within 
double quotation marks. The following are examples of strings: 
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“F. SCOTT FITZGERALD” 

"149 LEXINGTON AVE” 

"NEW YORK, NY 10017” 

"212-349-9879” 

Notice that a string can contain both letters, numbers and 
symbols. Any string containing numbers cannot be used in a 
mathematical operation, unless it is first converted into numeric 
data. String to numeric data conversion is covered later in this 
chapter. 

NUMERIC DATA 

The lie can use either of two types of numeric data — integers and 
floating point numbers. Integers do not have a decimal portion 
while floating point numbers can have a decimal portion. 

Applesoft BASIC can process both integers and floating point 
numbers while Integer BASIC can only process integers. 

Floating Decimal Point 

With floating decimal point numbers, a decimal point is always 
assumed. Any number of digits can be placed on either side of 
this decimal point. Even with numbers with no decimal position, 
a decimal point always is assumed following the number's last 
digit. 

Floating point numbers of up to 9 digits can be used with 
Applesoft BASIC. For example, the following entry of a nine digit 
floating point number: 



PRINT .566666666 

would generate a nine digit display. If a 10 digit floating point 
number was entered: 



PRINT .5666666666 

the last digit would not be displayed and the number would be 
rounded as follows: 
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.566666667 

Commas may not be included within numeric data. For example, 
109000 would be a valid number in Applesoft BASIC while 
109,000 would be invalid. 

Floating point numbers include both integers, as well as numbers 
with decimal positions. The following are examples of floating 
point numbers: 

-.0789 

5 

77.39 

0 

+.000001 

67.98 

Negative floating point numbers should be preceded with the 
minus sign (-). Positive floating numbers can optionally be 
preceded with the plus sign (+), however, a floating point 
number is assumed positive if it doesn't have a sign. 

Integer 

An integer is a number without a decimal position. Integers can 
either be positive or negative. The following are examples of 
integers: 



-1134 

0 

1 

-1 

17945 

+32 

Integers can range from -32768 to +32767. Negative integers are 
preceded with the (-) sign. Positive integers can be preceded 
with the (+) sign, although integers without a (+) sign are assumed 
to be positive. 
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Scientific Notation 

Applesoft BASIC uses scientific notation to express either 
extremely large or extremely small numbers. A number in 
scientific notation takes the following format: 

±x E + yy 



Where; 

± is an optional plus or minus sign. 

x can either be an integer or floating point number. 
This value is know as the coefficient or mantissa. 



E stands for exponent. 

yy is a one or two digit exponent. The exponent gives 
the number of places that the decimal point must be 
moved to give its true location. The decimal point is 
moved to the right with the positive exponents. The 
decimal point is moved to the left with negative 
exponents. 

The following examples specify a number in both standard 
floating point and scientific notation: 

1000000 — ► 1 E6 
.000001 — ► 1 E-6 
57500000 — ►- 5.75 E+07 
-.00000479— ► -4.79 E-06 

Any integers containing 10 or more digits will be expressed in 
scientific notation as shown in the following example. 

PRINT 121212121212 
1.21212121 E+11 
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Notice that the decimal portion of the preceding example 
contains 8 digits of precision. Applesoft will round any additional 
digits. 

Applesoft can only handle numbers expressed in scientific 
notation in the following range: 

Largest floating point number— ►+1.70141183E+38 
Smallest floating point number— ►+2.93873588E-39 

If a larger number is encountered, the following error message 
will be displayed. 



OVERFLOW ERROR 

Any numbers smaller than that allowed will be assigned a value 
of 0. 

VARIABLES 

So far, we have only discussed data constants. A constant can be 
defined as a fixed value. The following are examples of string and 
numeric constants. 



“JACK NOVET” 

“375” 

27.59 

0 

100000 

A name can be used to express data as well as a constant. 
Variables are used to express data as a name. 

BASIC Variables 

A variable can be defined as a quantity that can assume any one 
of a group of values. Variables are represented by variable 
names. These consist of a letter followed optionally by additional 
letters and/or numbers. The value assumed by a variable is 
subject to change, depending upon the program statement 
being executed. For example, in the following: 
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100 LET A = 5.0 
200 LET B = 7.0 
300 LET A = A + B 

the variable A is initially assigned a value of 5.0 and B is assigned a 
value of 7.0. In line 300, the variable A is assigned a new value 
equal to the sum of variables A and B, which is 12.0. The previous 
value of A is erased. 

BASIC Variable Names 

Applesoft BASIC allows any group of up to 238 characters to be 
used as a variable name— as long as the first character of the 
group is a capital letter of the alphabet, and as long as the 
variable name does not duplicate a reserved word (see Appen- 
dices A & B). Examples of reserved words are: 

LEJ, GOTO, IF, READ, DATA 

The following are examples of valid Applesoft BASIC variable 
names: 

A JOHN 

B23456 N4N 

DOT B% 

A2 N 

While the following are invalid variable names: 

2BB7 END 

1A FOR 

PRINT COS 

All of the preceding examples of valid variable names should be 
used to represent numeric data. Variable names can also be used 
to represent string data. These are known as string variables. 
String variable names consist of a valid variable name followed 
by the dollar sign ($). The following are examples of valid string 
variable names. 
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A$ 


NEDS 


zip$ 


MOPS 


A7$ 


N222S 



A distinction can also be made among numeric variable names 
between floating point variable names and integer variable 
names. In the following example, A1 is used to represent a 
floating point number, while A% represents an integer. 

100 A1 = 1.75:A% = A1 *2 
200 PRINT A1, A% 

RUN 

1.75 3 

Notice that only the integer value of A% is output. The decimal 
portion is dropped or truncated as A% can only accept integer 
values. 

Keep in mind that although Applesoft allows variable names of 
up to 255 characters, only the first 2 alphanumeric characters are 
recognized by the interpreter. In other words, the following 
variable names would be identified as being identical by the 
Applesoft interpreter. 



TELLER 

TENNIS 

TENNESSEE 

However, the special symbols which identify the variable type 
(i.e. $, %) differentiate among variables with identical 2 character 
names. The following variable names would all be identified as 
unique by the Applesoft interpreter. 

TE% 

TE 

TE$ 



TABLES & ARRAYS 

Earlier in this chapter, we introduced the concept of variables. A 
variable is designed to hold a single data item—either string or 
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numeric. However, some programs require that hundreds or 
even thousands of variable names be used. 

Obviously, the use of thousands of individual variable names 
could prove extremely cumbersome. To overcome this problem, 
BASIC allows the use of subscripted variables. Subscripted 
variables are identified with a subscript, a number appearing 
within parentheses immediately after the variable name. An 
example of a group of subscripted variables is given below: 

A(0), A(1), A(2), A(3), A(4),..., A(100) 

Note that each subscripted variable is a unique variable. In other 
words, A(0) differs from A(1), A(2), A(3), A(4), etc. 

Subscripted variables should be visualized as an array (or table). 
In our previous example, the data contained in the array defined 
by A would consist of one row with 101 columns in it. Such an 
array is a single-dimension array. 

In Applesoft BASIC, arrays of up to eleven*elements can be used 
as needed in a program. Arrays which contain more than eleven 
elements must first be identified via the Dimension (DIM) 
statement. When an array is dimensioned, BASIC will reserve an 
area in memory for that array's elements. The following 
Dimension statement will dimension a numeric array of 16 
elements. 



100 DIM B(15) 

More than one array can be defined with a single DIM 
statement. This is shown in the example below: 

100 DIM Z(5,2), B(100), C(2,3) 



*An array of eleven elements would contain the subscripts 0 
through 10 inclusive. For example, an array dimensioned as A(10) 
would have eleven elements A(0) through A(10) inclusive. 
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A DIM statement should appear in a program before the array 
variable it is dimensioning appears. If an array variable is used in 
a program before it is dimensioned, the Bad Subscript error may 
occur. 

An array can also consist of two dimensions. Such an array is 
known as a two-dimensional array (or table). An example of an 
array of 4 rows and 3 columns is shown in Illustration 3-2. 

A two-dimensional array contains two subscripts. The first 
subscript contains the row location, while the second subscript 
contains the column location. The subscripted variable A(1,0) 
identifies the darkened area in the array shown in Illustration 
3-2. 

Illustration 3-2. Two-Dimensional Array 

Columns 




Expressions and Operators 

The values of variables and constants are combined to form a 
new value through the use of expressions. The following are 
examples of expressions. 

4 + 7 
A$+ B$ 

3*2 
14— =21 
X AND Y 

Applesoft BASIC includes several types of expressions including 
arithmetic, relational, and Boolean. In our previous examples, 
the first three examples are arithmetic expressions, while the 
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fourth and fifth are examples of relational and Boolean expres- 
sions respectively. Each of these types of expressions will be 
discussed in detail in the following sections. 

The sign or phrase describing the operation to be undertaken is 
known as the operator. The operators in our previous example 
were as follows: 



+ 

+ 

* 

-c 

AND 

The constants or variables which are affected by the operator are 
known as operands. 

Compound Expressions and Order of Evaluation 

All of our preceding examples were simple expressions. A simple 
expression is one which contains just one operator and one or 
two operands. Simple expressions can be combined to form 
compound expressions. The following are examples of 
compound expressions. 

(A + B) * 7-4 

(A + B) AND (C + D) 

IFA = 1 AND B = 1 THEN C = 1 

With compound expressions, it is necessary that the computer 
knows which operation should be undertaken first. Applesoft 
BASIC follows a standard order of evaluation within compound 
expressions. This order is outlined in Table 3-1. 

Note that parentheses have the highest precedence level. In 
other words, any expression enclosed within parentheses will be 
evaluated first. If more than one set of parentheses appears in an 
expression, these will be evaluated from left to right. 



One pair of parentheses can be used to enclose an operator 
enclosed within another set. In such an instance, Applesoft 
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BASIC will evaluate the expression within the innermost set of 
parentheses first, followed by the next innermost set, etc. 



Table 3-1. Order of Evaluation 





Operator 


Description 


Parentheses 


( ) 


Used to alter order 
of evaluation. 




A 


Exponentiation 




- 


Unary Minus 


Arithmetic 


* 


Multiplication 


Operators 


/ 


Division 




+ 


Addition 




- 


Subtraction 




= 


Equal To 






Not Equal To 


Relational 




Less Than 


Operators 


> 


Greater Than 




-< = 


Less Than or Equal To 




— —..ii 


Greater Than or 
Equal To 


Boolean 


NOT 


Logical Complement 


Operators 


AND 


Logical AND 




OR 


Logical OR 



When expressions have the same order of evaluation, they will 
be evaluated in order from left to right within the compound 
expression. 



Arithmetic Operations 

The symbols used for addition, subtraction, multiplication, 
division, and exponentiation are known as arithmetic operators 
in BASIC. The symbols + and - are used for addition and 
subtraction respectively. The asterik (*) is used to indicate 
multiplication, while the slash (/) is used to indicate division. 
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When a + or - sign precedes a number, the symbol is used to 
specify that number's sign. When + or - is used to change a 
number's sign, that usage is known as a unary operation. Unary 
operators can be used to change the sign of a numeric constant 
or variable as shown below: 

100 LET A = -A 

When unary operators are used in the manner shown above, the 
unary operation is regarded as an arithmetic operation. 

The term arithmetic expression is used to describe the use of an 
arithmetic operator with numeric constants and/or variables. 
The following are examples of arithmetic expressions. 

X + Y + 70 
100/A + B 
3000 * 10 + 1 

Exponentiation is the process of raising a number to a specified 
power. For example, in the following, 

A= 

the numeric variable A would be evaluated as: 



A* A* A* A* A 

In Applesoft BASIC, exponentiation is indicated with the caret 
arrow symbol,* . 

Exponentiation can be used in an arithmetic expression as shown 
below: 



8*3+7* 2 



The preceding expression would evaluate to 73. 
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A relational operation evaluates to either true or false. For 
example, if the constant 1.0 was compared to the constant 2.0 to 
see whether they were equal, the expression would evaluate'to 
false. In Applesoft BASIC, a non-zero value represents a condi- 
tion of true, while a value of 0 represents false. 



. S' 

The only values returned by a comparison in BASIC are 1 (true) 
or 0 (false). These values can be used as any other integer would 
be used. The following results are generated by the following 
relational expressions. 



5 >7 ►O (false) 

3 = 3 1 (true) 

2 0 2 ► 0 (false) 

(2 = 2) * 4 ► 4 

(1 > 7) + 7 7 



The first three examples are easy enough to understand. In the 
fourth example, the relational expression (2=2) is evaluated first 
as true or 1. This result is then multiplied by 4 with a product of 4 
as the result. In the fifth example, the relational expression (1 >- 7 ) 
evaluates as false or 0. This result is added to 7 , with the result 
being 7. 

Relational operations using numeric operations are fairly straight- 
forward. However, relational operations using string values may 
prove confusing to the first-time computer user. 

Strings are compared by taking the ASCII value for each 
character in the string one at a time and comparing the codes. 

If the strings are of the same length, then the string containing 
the first character with a lower code number is the lesser. Blank 
spaces are counted in string comparisons and have the ASCII 
value of 32. 
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The following comparisons between strings would all evaluate as 
true. 

“ABC” = “ABC” 

“ABC ”»“ABC” 

“BAA” > “AAA” 

“ALFRED” < “ALFREDO” 

A$ < Z$ where A$="ALFRED" and Z$="ALFREDO" 

Note that all string constants must be enclosed in quotation 
marks when used as constants. 

Logical Operators 

Logical or Boolean operations are generally used in BASIC to 
compare the outcomes of two relational operations. Logical 
operations themselves return a true or false value which will be 
used to determine program flow. 

The logical operators are NOT (logical complement), AND 
(conjunction), and OR (disjunction). These are best explained 
with a simple analogy. Suppose that Steve and Sherry were 
shopping in the produce department of their grocery store. If 
they decided to collectively purchase an item if either of them 
individually wanted that item, they would be acting under the 
OR logical operator. 

Now, suppose that Steve and Sherry decided that they would 
only purchase an item if they both wanted that item. They would 
then be acting under the AND logical operation. 

Now, suppose that Sherry was angry with Steve. If Sherry 
decided not to purchase the items that Steve wanted, she would 
be acting under the NOT logical operation. The NOT, AND, and 
OR logical operators are summarized in Illustration 3-3. 

A logical operator evaluates an input of one or more operands 
with true or false values. The logical operator evaluates these 
true or false values and returns a value of true or false itself. An 
operand of a logical operator is evaluated as true if it has a 
non-zero value. (Remember, relational operators return a value 
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of +1 for a true value.). An operand of a logical operator is 
evaluated as false if it is equal to zero. 

The result of a logical operation is also a number, which if 
non-zero is considered true, and false if it is zero. 

The following are examples of the use of logical operators in 
combination with relational operators in decision making. 

IF X=»-10 OR Y**=0 THEN 900 
IF A>-0 AND B=^0 THEN 200 
B=-1 :PRINT NOT B 

In the first example, the result of the logical operation will be 
true if variable X has a value greater than 10 or if variable Y has a 
value less than 0. Otherwise, it will be false. If the result of the 
logical operation is true, the program will branch to line 900. 
Otherwise, it will continue to the next statement. 

In the second example, the result of the logical operation will be 
true only if the value of both variables A and B are greater than 
zero. If the result of the logical operation is true, program 
control will branch to line 200. Otherwise, program control will 
branch to the next line. 

In the third example, B is set to a value of -1 (true). The value of 
NOT B is then printed. This will be 0 or false. 

Illustration 3-3 contains tables that may prove of help when 
evaluating program statements using logical operators in 
combination with relational operators. 
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Illustration 3-3. Logical Operators 



NOT Operation 



I T TJ a Operand 
I F 1 T | NOT A 



AND Operation 





T 1 F | F | 


rr 


1 F 1 T 1 F 1 



IT 



OR Operator 
|T | T ll 
IT I F | 1 



F | 



D 

n 



A Operand 
B Operand 
A AND B 



A Operand 
B Operand 
A OR B 



APPLESOFT BASIC STATEMENTS 

In the next several sections, we will discuss many of the more 
commonly used statements in Applesoft BASIC. These include 
the following: 

Remark Statements 
Assignment Statements 
Output Statements 
Input Statements 
Loops 

Conditional Statements 
Branching Statements 
Subroutines 

Applesoft BASIC Functions 
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Remark Statements 

Remark statements are used to include a programmer's 
comments within a program. It is good programming practice to 
include numerous Remark statements in your programs. Not 
only do Remark statements make your programs easier for 
others to understand, they also help you remember your 
program's logic. 

Remark statements consist of a line number, the reserved word 
REM, and the programmer's comment. An example of a Remark 
statement is given below. 

100 REM Initialize 1 to 0 

Remark statements are ignored by the Applesoft BASIC inter- 
preter, but are included in program listings. 

In multiple line statements, the REM statement must be the final 
statement. The Applesoft BASIC interpreter ignores all text 
following the keyword REM. 

Assignment Statements 

Assignment statements were discussed briefly earlier in this 
chapter. Assignment statements are used to assign values to 
variables. The following are examples of assignment statements. 

100 LET A = 7 

200 B = 42 

300 NAS = “PHIL" 

400 X=1: Y=2:Z=3 

Notice that the keyword LET is optional. Generally, LET is 
assumed. Both string and numeric variables can be assigned 
values with an assignment statement. Also, multiple assignment 
statements can be included in a single line, as long as each of the 
individual statements is separated with a colon. 
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DATA, READ Assignment Statements 

Assigning values to a large number of variables with individual 
assignment statements could prove very cumbersome. The 
DATA, READ statement can be used to assign values to a large 
number of variables. The following is an example of a DATA, 
READ statment. 

100 DATA 100, 500, 1000, “JACK" 1 
200 READ A, B, C, D$ 

The DATA statement creates a list of constant values known as a 
DATA list. The items in the DATA list are assigned sequentially to 
the variables in the READ statement. A DATA list is depicted in 
Illustration 3-4. 

DATA statements may contain numeric or string values. These 
values must be separated or delimited with commas. DATA 
statements may appear at any point in the program. No other 
statements can appear in the same program line with a DATA 
statement. 

The DATA list uses a pointer to indicate which value within the 
list is to be assigned to the next variable in a READ statement. 
Before the first READ statement is encountered, the DATA list 
pointer will point to the first value in the DATA list. As values 
from the DATA list are assigned to variables in the READ 
statement, the pointer will move sequentially to each successive 
item in the DATA list. 

The values from the DATA list must match the type of variable to 
which they are assigned in the READ statement. In other words, a 
string value cannot be assigned to a numeric or vice versa. 




64 Apple lie Users Handbook 



Illustration 3-4. DATA List 



100 DATA 100, 200, 300, 400, 500 



400 DATA MONDAY, TUESDAY, WEDNESDAY, 
THURSDAY, FRIDAY 




execution of line 900. 



The RESTORE statement is used to reset the DATA list. In 
Illustration 3-4, note the use of the RESTORE statement. After 
DATA list values have been read into A, B, C, D, and E in line 500, 
a RESTORE statement is executed. This causes the DATA list 
pointer to be reset to the beginning of the DATA list. 
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Outputting Data 

In some of our preceding examples, we touched upon the use of 
the PRINT statement to display data. The PRINT statement can be 
used to display both numeric and string data. 

The following program statement, 

100 PRINT "VENDOR LIST" 

would display the following at the current cursor position: 

VENDOR LIST 

The first item in a PRINT statement is displayed at the cursor's 
current location. 

When the Apple lie is used on the 40 column mode, two or more 
data items could be output to the screen by separating these 
items with commas in the PRINT statement. Upon encountering 
a comma as k delimiter, PRINT will output the next item at the 
next tab stop. In Integer BASIC, tab stops are set at columns 1, 9, 
12, 25, and 33. In Applesoft BASIC, tabs are set at columns 1, 16, 
and 33. 

When the Apple lie is used in the 80-column mode, only two 
tab stops are present. In Integer BASIC, the tab stops are located 
at columns 1 and 9. In Applesoft, they are located at columns 1 
and 17. 

The following examples illustrate the use of the comma with 
PRINT in the 40 and 80 column modes. 

Integer 40 Column 

> PRINT 1,2,3,4,5,6 
1 2 3 4 5 
6 

Applesoft - 40 Column 

] PRINT 1,2,3,4,5,6 
1 2 3 

4 5 6 
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"Integer 80 Column 

> PRINT 1,2,3, 4, 5,6 
1 6 

"Applesoft - 80 Column 

] PRINT 1,2,3,4,5,6 
1 6 

A semicolon can also be used to separate the items in a PRINT 
statement. A semicolon causes the next item in the PRINT 
statement to be displayed immediately after the preceding item. 
Unlike the use of the comma in a PRINT statement, when 
semicolons are used to separate items, no blank spaces appear 
between string or numeric values. 

When a PRINT statement has finished execution, the cursor 
moves to the left margin of the following line. This is known as a 

carriage return/line feed. 

If a comma or semicolon occurs at the end of a PRINT statement, 
the carriage return/line feed will be suppressed. If a comma is 
placed at the end of the PRINT statement, the next PRINT 
statement will begin output at the next print zone after the last 
item is displayed. If a semicolon is placed at the end of the PRINT 
statement, the next PRINT statement will begin output 
immediately following the last item displayed. 

In this section, we have only discussed sending output to the 
video display. Output can also be sent to the printer. This is 
accomplished by executing the PR# statement prior to PRINT. 

The usage of PR# to send data to the printer is discussed in 
Appendix H. 



•In the 80 column mode, each comma causes the subsequent 
value to be displayed in the second tab position. In our 
examples, 2,3,4,5, and finally 6 were successively displayed in 
the second tab position. 
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INPUT Statements 

Data can be input into the computer while a program is being 
executed. This is accomplished with the INPUT statement. 
For example, when the following statement is executed: 

100 INPUT A 

the computer will display a question mark and wait for the 
operator to enter a response. That entry will be assigned to the 
variable A. The entry must be ended by pressing the Enter key. 
Program execution will then resume. 

The values of several numeric variables can be input with a single 
INPUT statement as shown in the example below. 

200 INPUT X, Y, Z 

When the preceding INPUT statement is executed, the INPUT 
prompt (?) wild be displayed. The operator should then enter the 
data items for X, Y, and Z. Each input should be separated by a 
comma. The Return key should be pressed after all input entries 
have been made. An example of a valid entry for the preceding 
INPUT statement is given below. 

100, 200, 300 [Ret]* 

Caution should be used when inputting string data. Be certain 
that your string entries do not contain a comma unless enclosed 
in quotation marks. A comma will be interpreted by Applesoft 
BASIC as a delimiter. Any data appearing after the comma will be 
treated as a separate INPUT statement data item. 



* [Ret] indicates pressing the Return Key. 
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For example, in the following program; 

100 INPUT A$, B$ 

200 PRINT A$,B$ 

RUN 

? SMITH JOHN JONES, TED 
?EXTRA IGNORED 
SMITH JOHN 

A$ would be assigned “SMITH”, and B$ would be assigned 
“JOHN”. “JONES” and “TED” would be ignored as the error 
message (?EXTRA IGNORED) illustrates. 

Therefore, when inputting a string item, be certain a comma 
does not appear within that string. 

The variable type used with INPUT should be of the same type as 
the data input. String data cannot be input into numeric 
variables. If this does occur, the error message ?REENTER will 
appear, and the operator will be prompted for a new entry. If a 
real number is input for an integer variable, the decimal portion 
of the real number will be truncated. If numeric data is input for 
a string variable, that data will be interpreted as a string and 
cannot be used in calculations. 

It is good programming practice to include a prompt message in 
conjunction with the INPUT statement to remind the operator 
what data the computer is expecting. The prompt should be 
enclosed within quotation marks after INPUT. The prompt 
should be followed by a semicolon* and the variable or variables 
into which data is to be input. The prompt message will be 
displayed on the screen followed by the ? prompt. An example 
of an INPUT statement with a prompt is given as follows. 

100 INPUT “CUSTOMER NAME ”; A$ 

200 PRINT A$ 



* In Integer BASIC, the prompt is followed by a comma. 
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GET 

Applesoft's GET statement allows a single character to be input 
via the keyboard. That character is not displayed on the screen. 
Also, the return key need not be pressed after the entry has been 
made. The following program illustrates the usage of GET. 

70 PRINT “IF YOU WISH TO STOP— ENTER Y” 

90 PRINT “OTHERWISE, PRESS ANY KEY” 

100 GET Z$ 

130 IF Z$ = "Y" GOTO 950 
140 PRINT Z$ 

150 GOTO 70 

950 PRINT “PROGRAM ENDS” 

999 END 

If a string variable is used with GET, the character entered will be 
treated as a string value. If a numeric variable is used with GET, 
the character entered must be ^ number. If a non-numeric 
character is entered, the SYNTAX ERROR message will appear 
and the program will end. 

FOR, NEXT Loops 

Suppose tlyat you needed to compute the squares of the integers 
from 1 to 20. One way of doing this is by calculating the square 
for each individual integer as shown below. 



100 


A = 1 A2 


200 


PRINT A 


300 


B = 2A2 


400 


PRINT B 


500 


C = 3A2 


600 


PRINT C 
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However, this method is very cumbersome. This problem could 
be solved much more efficiently through the use of a FOR, NEXT 
loop as shown below. 



100 FOR A = 1 TO 20 
200 X = A * 2 
300 PRINT X 
400 NEXT A 
500 END 



The sequence of statements from 100 to 400 is known as a loop. 
When the computer encounters the FOR statement in line 100, 
the variable A is set to 1. X is then calculated and displayed in 
lines 200 and 300. 

The NEXT statement in line 400 will request the next value for A. 
Execution returns to line 100 where the value of A is incremented 
by 1 (to 2) and then compared to the value appearing after TO. 
Since the value of A is less than that value, the loop will be 
executed again with the value of A set at 2. 

The loop will continue to be executed until A attains a value 
greater than 20. When this occurs, the statement following the 
NEXT statement will be executed. 

In our preceding example, A is known as an index variable. If the 
optional keyword STEP is not included with the FOR statement, 
the index variable will be incremented by 1 every time the NEXT 
statement is executed. 

STEP can be included at the end of a FOR statement to change 
the value by which the index variable is incremented. The 
integer appearing after STEP is the new increment. For example, 
if our preceding example were changed as follows, 

100 FOR A = 1 TO 20 STEP 2 
200 X = A A 2 
300 PRINT X 
400 NEXT A 
500 END 
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the index variable A would be incremented by 2 every time the 
NEXT statement was executed. 

Nested Loops 

One loop can be placed inside another loop. The innermost 
loop is known as a nested loop. The following program contains 
a nested loop. 



50 DIM R (2,3) 

100 DATA 10, 20, 30, 40, 50, 60 
200 FOR I = 1 TO 2 
300 FOR J = 1 TO 3 
400 READ R (l,J) 

450 PRINT R (l,J) 

500 N EXT J 
600 NEXT I 

Our preceding example is used to read data into the numeric 
array R. 

One error that you should take care to avoid when using nested 
loops is to end an outer loop before an inner loop is ended. 

Conditional Statements 

One of the most important features of a computer is its ability to 
make a decision. BASIC uses the IF, THEN statement to take 
advantage of the computer’s decision making ability. The IF, 
THEN statement takes the following form: 

IF expression THEN statement or line number 

The IF statement sets up a question or a condition. If the answer 
to that question is true, the statement or line number following 
THEN is executed. If the answer is false, all instructions following 
THEN are ignored, and program execution will resume with the 
next line number in the program. 

In the following example, if 1 is input for X, the Y is set equal to 1 . 
Otherwise, Y’s value remains 0. 
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20 INPUT X 
50 Y = 0 

100 IF X = 1 THEN Y = 1 
200 PRINT X: PRINT Y 

Branching Statements 

Branching statements change the execution pattern of programs 
from their usual line by line execution in ascending line number 
order. A branching statement allows program control to be 
altered to any line number desired. The most commonly used 
branching statements in BASIC are GOTO and GOSUB. 

GOTO takes the following format: 

GOTO line number 

For example, the following program statement, 

500 GOTO 999 



999 END 

would branch program control at line 500 to line 999. 

Branching statements are often used in conjunction with con- 
ditional statements. In such a situation, the normal execution of 
the program is altered depending upon the outcome of the 
condition set up in the IF statement. This is shown in the 
following example. 

100 INPUT "ENTER THE AMOUNT ";A 

200 IF A = 0 THEN GOTO 900 

300 PRINT A 

400 GOT0 100 

900 INPUT "FINISHED ";B$ 

910 IF B$ = "N"THEN 100 
999 END 
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In our preceding example, if the value input for A has a zero 
value, then the program will branch to line 900 where the 
operator will be prompted whether he has finished entering 
data. In line 910, the program will set up a condition where if the 
input was ‘N’, the program will branch to line 100. If the entry was 
not equal to ‘N’, the program will continue to line 999 where it 
will end. " i 

Note in line 910 that a GOTO statement is not used to precede 
the line number being branched to. When a line number is 
indicated following a THEN statement, the computer does not 
require the presence of GOTO, which is assumed. 

ON, GOTO Statement 

The ON, GOTO statement is a combination of a conditional 
statement and a branching statement. The use of the ON, GOTO 
statement is illustrated in the following program. 

10 INPUT A 

20 ON A GOTO 40, 50 

30 GOTO 99 

40 PRINT “A = 1”: GOTO 99 
50 PRINT “A = 2” 

99 END 

If the variable or expression following ON evaluates to 1, 
program control branches to the first line number specified after 
GOTO; if 2, to the second; if 3, to the third, etc. 

If the variable or expression evaluates to a number greater than 
the number of line numbers following GOTO, program control 
will branch to the statement immediately following the ON, 
GOTO statement. This is also the case if the variable or 
expression following ON evaluates to zero. 

Subroutines & GOSUB Statements 

Many times you will find that the same set of program instructions 
are used more than once in a program. Re-entering these 
instructions throughout the program can be very time con- 
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suming. By using subroutines, these additional entries will be 
unnecessary. 

A subroutine can be defined as a program which appears within 
another larger program. The subroutine may be executed as 
many times as desired. 

The execution of subroutines is controlled by the COSUB and 
RETURN statements. The format for the GOSUB statement is as 
follows. 

GOSUB line number 

The computer will begin execution of the subroutine beginning 
at the line number indicated. Statements will continue to be 
executed in order, until a RETURN statement is encountered. 
Upon execution of the RETURN statement, the ^computer will 
branch out of the subroutine back to the first line following the 
original GOSUB statement. This is illustrated in the following 
example. 

Illustration 4-5. BASIC Program With a Subroutine 

10 INPUT“PAY TO THE ORDER OF ”;A$ 

20 INPUT “CHECK AMOUNT ”;X 
30 IF X = 0 THEN 200 

, 40 IF X<0 THEN GOSUB 100 

50 IF X > 1000 THEN GOSUB 100 

60 IF (X >0) AND (X <1000) THEN PRINT A$,X 

70 GOTO 10 

{ 100 PRINT “NOT VALID AMOUNT” 

110 INPUT “TRY AGAIN ”;X 
120 RETURN 
200 END 

Subroutines can help the programmer organize his program 
more efficiently. Subroutines also can make writing a program 
easier. By dividing a lengthy program into a number of smaller 
subroutines, the complexity of the program will be reduced. 
Individual subroutines are smaller and therefore more easily 
written. Subroutines are also more easily debugged than a 
longer program. 
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ON, GOSUB Statement 

The ON, GOSUB statement is very similar in nature to the ON, 
GOTO statement. The following statement is an example of an 
ON, GOSUB statement/ 

100 ON X GOSUB 1000, 2000, 3000 

If the value of X is 1, the subroutine at line 1000 is executed. If X is 
2, the subroutine at line 2000 is executed. If X is 3, the subroutine 
at line 3000 is executed. If X evaluates to 0 or to a number greater 
than 3, the statement immediately following the ON, GOSUB 
statement will be executed. 

If ON, GOSUB causes a branch to a subroutine, program control 
will revert to the line immediately following the ON, GOSUB 
statement, once the subroutine has been executed. 

Applesoft BASIC Functions 

Functions are used in Applesoft BASIC to perform predefined 
calculations or operations on their arguments. All functions use 
the following format. 



function (argument) 

function is the keyword for the function, argument is a variable, 
constant, or expression which is to be stored in the operation 
defined by the function. 

The following statement is an example of the use of the SQR 
function. 



100 A = SQR (49) 

In this example, A would evaluate at 7. SQR is the keyword which 
describes the square root function. The square root of 49 is, of 
course, equal to 7. 

Functions can be used with arithmetic, relational, and Boolean 
expressions, as shown in the following statement. 
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100 X = 100- 7 * SQR(49) 

In an expression containing functions as well as arithmetic, 
relational, and/or Boolean operators, the function’s value is 
calculated first. In our preceding example, the square root of 49 
would be calculated, that value would be multiplied by 7, and 
the product subtracted from 100. 

Applesoft BASIC also includes a number of functions for 
performing operations on strings. These include: 

LEFTS 

MID$ 

RIGHTS 

These functions can be used to extract one or more characters 
from a string. 

The various Applesoft BASIC functions are described in Chapter 
4. 

String Concatenation 

The addition operator (+) can be used to join together or 
concatenate two strings. When concatenating strings, re- 
member that the maximum length of a string in Applesoft BASIC 
is 255 characters. 

The following program illustrates string concatenation. 

100 AS = “JOHN" 

200 B$ = “BILL" 

300 C$ = A$ + B$ 

400 PRINT CS 
500 END 
RUN 

JOHNBILL 

The subtraction operator (-) cannot be used to separate a 
portion of a string. 
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ASCII 

The lie cannot store characters; it can only store numbers. 
Before characters can be stored, they must be converted to 
numbers. Computers use special numeric codes to store char- 
acters. Most microcomputers use a code known as ASCII 
(American Standard Code for Information Interchange). 

The codes used by the lie are listed in AppendixG. These codes 
can be activated by including them with the CHR$ function with 
a PRINT statement. For example, the following: 

PRINT CHR$(56) 

would cause the number 8 to be output on the display. 

CHR$ & ASC Functions 

As mentioned earlier, characters are represented with ASCII 
codes. Applesoft BASIC’s CHR$ function can be used to translate 
an ASCII code to its equivalent character. The following short 
program illustrates the use of the CHR$ function. 

100 PRINT CHR$(54) 

200 PRINT CHR$(55) 

300 END 
RUN 
6 
7 

The CHR$ function is often used to represent characters in a 
statement, when that character can not be represented in its text 
form. For example, in the following program, 

100 PRINT CHR$(34); “JOHN JOHNSON”; CHR$(34) 

200 END 
RUN 

“JOHN JOHNSON” 

quotation marks are specified in the PRINT statement using their 
ASCII code and the CHR$ function. 
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The ASC function returns the ASCII code equivalent for its string 
argument. If this string is longer than one character, the ASC 
function returns the ASCII code for just the first character in the 
string. 

The following program illustrates the use of the ASC function: 

100 A$ = “JOHN JOHNSON" 

200 PRINT ASC(A$) 

300 END 

RUN 

74 

PEEK AND POKE 

The PEEK and POKE statements allow direct access to the lie’s 
memory. The argument of PEEK and POKE indicates the address 
in memory to be accessed. Every memory location can store a 
number in the range 0 through 255. 

The PEEK function allows the user to examine the value stored in 
the memory location named as its argument. For example, in the 
following statement. 



100 N = PEEK (1000) 

the value stored at memory location 1000 will be assigned to the 
variable N. 

The POKE statement is used to place a value in a specified 
memory location. POKE uses the following configuration, 

POKE address, value 

where the value specified is placed in the location given in 
address, value and address can either be constants or variables. 
For example, in the following statement, 

100 POKE 2000, X 

the value stored in variable X will be POKE’d into memory 
location 2000. 
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STOPPING PROGRAM EXECUTION 

A number of different methods are available for stopping 
program execution on the lie. These will be discussed in the 
following sections. 

Control-C 

A program can be stopped by pressing the Control and C keys 
simultaneously. If Control-C is pressed in response to an INPUT 
statement prompt, the Return key must be pressed after 
Control-C to stop execution. 

When program execution is stopped by pressing Ctrl-C, the 
following message will be displayed (in Applesoft BASIC): 

BREAK IN line number 

The line number will be the line number where the program 
execution was stopped. Program execution can be resumed by 
entering CONT. 

In Integer BASIC, the following message will be displayed when 
program execution is Stopped using Ctrl-C. 

STOPPED AT line number 

Again, line number indicates the line where program execution 
was stopped. Program execution can be resumed by typing in 
CON. 

END 

The END statement can be used to stop program execution. 
Progam execution can be resumed once END has been executed 
by entering CONT. In Integer BASIC, program execution cannot 
be resumed once END has been executed. 
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STOP 

When a STOP statement is executed in Applesoft BASIC, 
program execution is halted, and the following message is 
displayed. 

BREAK IN line number 

Program execution can be resumed by entering CONT. 

RESET 



Pressing CONTROL-RESET will also stop execution of a program. 




CHAPTER 4. 

APPLE BASIC REFERENCE GUIDE 



INTRODUCTION 

In this chapter, we will provide descriptions of the various 
commands, statements, and functions used in Applesoft and 
Integer BASIC. 

The following rules and abbreviations will be followed in this 
chapter in our configuration descriptions of the various BASIC 
commands, statements, and functions. 

1. Any capitalized words are keywords. 

2. Any words, phrases, or letters shown in lowercase italics 
identify an entry that must be made by the operator (unless 
enclosed within brackets). 

3. Any items enclosed in brackets [ ] are optional. 

4. An ellipsis (...) shows that an item may be repeated as often 
as desired. 

5. Any punctuation marks, except the square brackets (ex. ; , 
=) must be included where they are shown. 



* Except [Ret]. 
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■ Applesoft 

■ Integer 



ABS 



The ABS function returns the absolute value of the argument. A 
number's absolute value is its value without regard to sign. 

Configuration 

ABS(argument) 

The argument can be any numeric expression or numeric 
constant. In Integer BASIC, the numeric constant must be an 
integer. 



Example 

10 A = ABS(-1 *7) 

20 PRINT A, ABS(2.99) 

1 RUN [Retl 
7 2.99 

In the preceding example, the absolute values of -7 and 2.99 are 
returned. 



AND 



■ Applesoft 

■ Integer 



AND is a logical math operator. This reserved word is generally 
used to compare two numeric expressions in the context of an IF, 
THEN statement. 



Configuration 

expressionl AND expression2 

expressionl and expression2 are Boolean expressions. If an 
expression was numeric (not zero), that expression would 
evaluate as true. For example, if an expression evaluated to 5, 
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AND would treat it as true. The following is the truth table for 
AND. 



X 


Y 


X AND Y 


true 


true 


true 


true 


false 


false 


false 


true 


false 


false 


false 


false 



In both Applesoft and Integer BASIC, a true is represented by al 
and false by a 0. 



Example 1 



10 A = 2 
20 B = 3 

30 IF (A = 2) AND (B = 3) THEN 60 
40 PRINT "AND FAILED LOGICAL TEST" 

50 GOTO 70 

60 PRINT "AND PASSED LOGICAL TEST" 

70 END 
]RUN [Ret] 

AND PASSED LOGICAL TEST 

In the preceding example, line 30 first tested the value of A. Since 
A was set equal to 2 in line 10, the first expression was evaluated 
as true. The value of B was then tested. It too evaluated as true. 
Using the logical AND table, if expressionl and expression 2 
evaluated to true, then the whole AND expression evaluated as 
true. The program will then execute the THEN portion of the 
statement and will branch to line 60. At line 60, the message AND 
PASSED LOGICAL TEST was displayed. 

Example 2 

PRINT (3 = 1+2) AND (-5) 

1 

In this example, 3 is set equal to 1 + 2, so the first expression 
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evaluates as true. The second expression (-5) is non-zero, so it is 
also evaluated as true. According to the AND truth table, if both 
expressions evaluate as true, then the whole expression is true. 
Applesoft and Integer BASIC represent true as 1, so a 1 is printed. 



■ Applesoft 

ASC ■ Integer 

The ASC function returns the ASCII code for the first character in 
its argument. 



Configuration 

ASC (argument) 

argument can be any string variable or constant. 

Example 



] A$ = "A" 



]PRINT ASC(A$), ASCfDEF") 

65 68 

In the preceding example, the character in the string A$ was A. 
A's ASCII equivalent is 65. In thesecond string, the first character 
D will be used as the argument. A value of 68 is returned for the 
ASCII value of D. 



ATN 



■ Applesoft 
□ Integer 



The ATN function is a trigonometric function that returns the 
arctangent of its argument. 
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Configuration 

ATN (argument) 

The argument can be a numeric expression or numeric constant 
in radians. The value returned will be the primary angle 

(--j< angle <j) 



Example 

10 PI = ATN(1) * 4 
20 PRINT PI, ATN(TAN(.2)) 

1 RUN fRetl 

3.14159266 .2 

In the preceding example, the arctangent of 1 returns the value 
7r/4. Multiplying this value by 4 returns the value indicated. 

In the second part of the PRINT statement, the argument .2 is 
returned. Since the ATN formula is the inverse of the TAN 
function, the value returned was the original argument. 



□ Applesoft 

AUTO ■ Integer 

The AUTO command generates a new line number every time 
the user presses Return. 



Configuration 

AUTO line number [/increment] 

Both linenumber and increment must be integers. The line- 
number will be the first line number generated. The increment is 
the amount to be added to the current line number to generate 
the next line number. If the increment is not included, the 
increment will be set to 10 by default. 
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The AUTO command is generally used when entering programs. 
This saves the user the task of typing every line number. 

The AUTO command is ended by pressing Ctrl-X and typing 
MAN. 



Example 

AUTO 30 
AUTO 10, 5 

The first command will generate the line numbers 30, 40, 50, and 
so on. The second command will generate the line numbers 10, 
15, 20, 25, 30, ... 

AUTO is not available in Applesoft BASIC. 



CALL 



■ Applesoft 

■ Integer 



The CALL statement is used to execute a machine language 
subroutine. 



Configuration 

CALL expression 

expression evaluates to an integer between -65535 and +65535. 
In Integer BASIC, the value of the expression must bean integer 
between -32767 and +32767. 

The expression is the location of the machine language sub- 
routine. 

In Applesoft, there are two values which will execute the same 
machine language subroutine. There is the positive address and 
the negative address. The conversion is as follows: 



positive address - 65536 = negative address 





Apple BASIC Reference Guide 87 



This can be very useful in Integer BASIC. If there was a machine 
language subroutine located at location 64578, a CALL 64578 
could not be used. This is due to the fact that the expression 
indicated is greater than the largest integer that can be used in 
Integer BASIC. Using the previous conversion equation, the 
CALL used would be CALL-958. 

Example 

CALL-936 

The preceding CALL executes a machine language subroutine at 
the given location. This CALL is identical to the HOME command 
in Applesoft. 



CHR$ 



■ Applesoft 
□ Integer 



The CHR$ function returns the ASCII character for the value 
given in the argument. 



Configuration 

CHR$(argument) 

argument is a real number or an integer between 0 and 255. If theT 
argument is a real number, its decimal portion will be truncated. 

Example 

10 X$ = CHR$(80) 

20 PRINT CHR$(65),X$ 

1 RUN [Ret] 

A P 



The ASCII code for A is 65 and the code for P is 80. 
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CLEAR 



■ Applesoft 
□ Integer 



CLEAR initializes all variables, arrays, and strings to zero. CLEAR 
also initializes all DATA pointers, FOR. ..NEXT counters, sub- 
routine pointers, etc. 



Configuration 

CLEAR 

CLEAR can be used anywhere in a program, but should not be 
used in a subroutine or FOR. ..NEXT loop. 

Example 

10 A = 10 
20 PRINT A 
30 CLEAR 
40 PRINT A 
1 RUN [Retl 
10 
0 

Line 30 sets variable A from 10 to 0. 



CLR 



□ Applesoft 
■ Integer 



CLR sets all variables to 0, strings to null, and clears any 
dimensioned variables. ; 



Configuration 

CLR 



CLR can only be used in the immediate mode. 
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Example 

A = 10 
B$ = "?" 

CLR 

PRINT A, B$ 

0 

The variable A is cleared to 0 and the string variable B$ is set to 
null. 



COLOR 



■ Applesoft 

■ Integer 



The COLOR statement defines the next color to be displayed by 
the graphics statements PLOT, HLIN...AT, and VLIN...AT. 

Configuration 

COLOR = expression 

The expression is an integer from 0 to 255. The computer can 
display * total of 16 different colors. The colors and their 
associated numbers are shown below. 



0 Black 


8 Brown 


1 Magenta 


9 Orange 


2 Dark Blue 


10 Grey 


3 Purple 


11 Pink 


4 Dark Green 


12 Green 


5 Grey 


13 Yellow 


6 Medium Blue 


14 Aqua 


7 Light Blue 


15 White 



Beyond 15, the colors repeat (16 - Black, 17 - Magenta). 
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Example 

10 GR 

20 COLOR =6 
30 PLOT 0,0 
40 END 

The preceding program will place a blue square in the upper left 
hand corner of the screen. 



CON 



□ Applesoft 
■ Integer 



The CON statement resumes program execution at the next 
instruction. 



Configuration 

CON 

This command is generally executed following a Ctrl-C. 

Example 

10 FOR X = 1 TO 10 
20 PRINT X, XA2, XA3 
30 NEXT X 
40 END 



> 


RUN [Ret] 




1 


1 


1 


2 


4 


8 


4 


16 


64 


5 


25 


125 


Ctrl-C pressed — STO ppED AT 30 


> CON [Ret] 




6 


36 


216 


7 


49 


343 


8 


64 


512 


9 


81 


729 


10 


100 


1000 
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In the preceding example, a Ctrl-C was entered in as shown. The 
Ctrl-C stopped the execution of the program. Entering in CON 
continued program execution. 



CONT 



■ Applesoft 
□ Integer 



CONT resumes program execution at the next instruction. 

Configuration 

CONT 

This command is generally executed following a STOP, END, or 
Ctrl-C. 



Example 

10 FOR I =1 TO 5 
20 PRINT I, IA2 
30 IF I = 3 THEN STOP 
40 NEXT I 
1 RUN [Ret] 

1 1 

2 4 

3 9 

BREAK IN 30 
]CONT [Ret] 

4 16 

5 25 

In the preceding example, program execution stopped in line 30 
when I =3. Typing in CONT continued program execution. 
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COS 



■ Applesoft 
□ Integer 



The COS function is a trigonometric function that returns the 
cosine of its argument. 



Configuration 

COS (argument) 

The argument is a numeric expression or numeric constant in 
radians. 



Example 

]PRINT COS(3. 141592653) 

-1 

In the preceding example, the cosine of PI is returned. 



DATA 



■ Applesoft 
□ Integer 



The DATA statement contains a list of data items. These data 
items are read into the variables specified by the READ state- 
ment. 



Configuration 

DATA item [/item...] 

item can either be a real number, integer, or string. The data 
items must be in the same order as they are read by the READ 
statement. 

If a comma or colon is to be included in the string, the item 
should be enclosed in quotes. The following characters cannot 





Apple BASIC Reference Guide 93 



be placed in a DATA statement. 

RETURN Ctrl-H 

ESC Ctrl-M 

" Ctrl-U 

(left arrow) Ctrl-X 

(right arrow) 

The preceding characters may be used in a program by 
executing the CHR$ function. 

The DATA statement can be located anywhere in a program. It 
does not have to precede the READ statement. 

Example 

10 DATA "SMITH, JOE", JOHN BROWN 
20 READ N1$, N2$ 

30 PRINT N1$, N2$ 

1 RUN [Ret] 

SMITH, JOE JOHN BROWN 

The READ interpreted the first string as SMITH, JOE because it 
was enclosed in quotes. The second string is read as JOHN 
BROWN. 



■ Applesoft 

DEF FN □ Integer 

The DEF FN statement allows the user to define a function. This 
function can then be used in the same manner as any built-in 
function. 



Configuration 

DEF FN name (variable) = expression 
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name is the name of the function. Like variable names, only the 
first two characters are significant. The variable can be any real 
numeric variable name. The expression can be a numeric 
constant or a numeric equation. 

Example 

10 PI = ATN(1) *4: REM PI 
20 DEF FNAR(X) = PI * XA2 
30 FOR RAD = 1 TO 3 
40 PRINT RAD, FNAR(RAD) 

50 NEXT RAD 
60 END 
1 RUN fRetl 

1 3.14159266 

2 12.5663706 

3 28.2743339 

In line 10, PI is calculated so it can be used in the function 
definition. In line 20, the function for the area of a circle is 
defined. Line 40 then uses the function by passing the value of 
the radius to the function. The value of the area of the circle is 
then returned and printed by the PRINT statement. 



■ Applesoft 

DEL ■ Integer 

DEL deletes the lines given in the argument. 

Configuration 

DEL a [,b]* 

a and b are integers greater than or equal to 0. In Applesoft, b 
must be greater than a. In Integer BASIC, if b is less than a only 

* The [,6] is only optional in Integer BASIC. 
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line a will be deleted. 

If a is not an existing line number in the program, the next 
highest line number will be used. If b is not an existing line 
number in the program, the next lowest line number will be 
used. 

The DEL can also be used as a program statement in Applesoft. If 
the DEL is used as a program statement, the specified lines will be 
deleted. However, program execution will halt after the 
statement has been executed. The CONT command will not 
resume program execution. 

Example 



]UST [Ret] 

10 TEXT 

20 CALL-936: REM HOME 
30 VTAB 3 
40 PRINT "HELLO" 

50 END 

]DEL 30,50 [Ret] 

1LIST fRetl 
10 TEXT 

20 CALL -936: REM HOME 



DIM 



■ Applesoft 

■ Integer 



The DIM statement is used to allocate memory space for strings, 
arrays, or matrices. \ 



Configuration 

a (i[>j}-) [>b (i[,j]-] 
a% (/[,;]...) [,b% (/[,;]...] 
a$ (a$ (/[,;]...) [,b$ (/[,;]...] 



Applesoft 

DIM 
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Integer 

DIM 



a (i[,b(i)-] 
a$ (i[,b$(/)...] 



a and b are the variables to be dimensioned, i and j are integers. 
In Integer BASIC, the string variable must be dimensioned with 
255 elements or less. 



In Applesoft BASIC, all arrays, strings, and matrices are prede- 
fined with subscripts of 10. Above 10, the value in a DIM 
statement corresponds to the largest subscript that can be used 
in that variable. However, there is always a zero subscript. As a 
result, to save 100 values in a single dimension array, the correct 
DIM statement would be DIM A(99). 

In Integer BASIC, the value in a DIM statement corresponds to 
the largest subscript that can be used with that variable. An 
Integer variable with a subscript of 0 is the same as a variable 
without the subscript. If TEST(O) = 27, then TEST is also equal to 27 
and vice versa. With string variables, there is no 0 subscript. 

The maximum size of strings and arrays depends on the amount 
of available memory at the time the DIM statement was 
executed. 



If the DIM statement exceeds the amount of available memory, 
the following error will occur: 

Applesoft BASIC ?OUT OF MEMORY ERROR IN line 

Integer BASIC ***MEM FULL ERR 
STOPPED AT line 

where line is the line of the DIM statement. 

Example — Applesoft 

DIM A$(10,5), C%(2,20) 

In the preceding example, 66 string spaces are allocated for A$, 
and 63 integer variables are defined for C%. 
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Example — Integer BASIC 

DIM A(10), N$(5) 

In the previous example, the DIM statement defines 10 spaces 
for the variable A, and N$(5) defines one string of length 5. 



DRAW 



■ Applesoft 
□ Integer 



The DRAW statement plots a shape on the high-resolution 
graphics page. 



Configuration 

DRAW shapeno [AT X, V] 

shapeno is an integer between 0 and 255. X and Y are integers for 
the position of the shape. X must lie between 0 and 279. Y must lie 
between 0 and 191. 

If AT X, V is not given, the shape will be plotted at the last X, Y 
position designated. 

The color, rotation, and size of the shape must have been 
previously defined. 

Example 

10 REM SET UP SCREEN 

20 TEXT:HGR 

30 FOR X = 7936 TO 7946 

40 READ V:REM READ IN SHAPE 

50 POKE X,V:REM POKE SHAPE INTO TABLE 

60 NEXT X 

70 REM TELL WHERE SHAPE IS AT 
80 POKE 232,0: POKE 233,31 
90 HCOLOR = 3 



program continued on the next page 
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100 ROT = 0 
110 SCALE = 10 
120 DRAW 1 AT 50,30 
130 HPLOT 20,70 
140 SCALE =6 
150 ROT = 4 

160 DRAW 1 / 

170 DATA 1,0,4,0,39,36,45,53,54,63,0 
180 END ' 

In the preceding example, line 20 initialized the screen for high 
resolution graphics. The shape table is then read in the FOR 
NEXT loop in lines 30 to 60. These lines define the shape. Since 
Applesoft needs to know where the shape table was placed, the 
shape address is poked into memory in line 80. Lines 90, 100, and 
110 then define the color, rotation, and size of the shape drawn 
at line 120. The shape drawn in line 160 will have the position 

defined at line 130, size in 140 and the rotation in 150. 

< 



DSP 



□ Applesoft 
■ Irtfeger 



The DSP command is a debugging tool. It displays the variable's 
value each time its value is changed. 

Configuration 

DSP variable 

variable is a variable in the program to be traced. 

The DSP command will display the variable, the variable's value, 
and line number each time its value is changed. 
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Example 

10 DSP A 
20 DSP B 
30 A =1 
40 B =7 
50 C = A*B 
60 B = C+A 
70 END 
1 RUN [Ret] 
#30 A = 1 
#40 B = 7 
#60 B = 8 



In the preceding example, the line number, variable, and 
variable values are displayed when the indicated variable’s 
values change. Notice that in line 50 the value of A and B is used, 
but not changed, so it is not displayed. 



END 



■ Applesoft 

■ Integer 



The END statement is used to stop program execution. 

Configuration 

END 

The END statement is optional in Applesoft. If it is not used, the 
program will stop execution at the highest line number. 

The END statement is optional in Integer BASIC, but if it is not 
included a NO END error will result. The program will essentially 
run the same with or without the END statement. 

Example 



999 END 
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EXP 



■ Applesoft 
□ Integer 



The EXP function returns the value of e raised to the power of the 
argument. 



Configuration 

EXP (argument) 

argument is a numeric constant or numeric expression, (e = 
2.71828183). 



Example 

PRINT EXP(5) 

/ 148.413159 

f 

In the preceding example, e 5 was returned. 



FLASH 



■ Applesoft 
□ Integer 



The FLASH statement turns on the FLASH video. Following the 
execution of the FLASH statement, any characters displayed by 
the computer will flash. The characters will alternate from black 
on white to white on black. 

Configuration 

FLASH 

Any characters echoed by the computer (entered through the 
keyboard), will not flash. 

The FLASH mode works by altering the standard ASCII code. So, 
any characters sent to the disk or printer while the FLASH mode 
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is on, may be sent with the incorrect codes. 

The FLASH statement is equivalent to a POKE 50,127. The FLASH 
statement is turned off by the NORMAL statement. 

Example 

] FLASH 

] PRINT"**'' 

** 

When the lie's 80-column card is activated (either in the 40 or 80 
column mode), the alternative character set will be active. The 
alternate does not include flashing characters. Therefore, FLASH 
does not function properly when the 80 column card is active. 

■ Applesoft 

FOR..NEXT ■ Integer 



The FOR.. NEXT statements are used to execute a sequence of 
statements a set number of times. 

Configuration 

FOR variable = a to b [STEP c] 



NEXT [variable*] [, variable ...] 

variable is a real variable in Applesoft. The variable is used as a 
counter, a, b and c are numeric expressions or constants. The 
numeric constant must be an integer in Integer BASIC, a is the 
initial value of the counter and b is the final value. The counter is 
incremented or decremented depending on the sign of c. If c is 
not given, it will be assumed as 1. 



* The variable in NEXT is only optional in Applesoft. 
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The program lines following the FOR statement will be executed 
until the NEXT statement is encountered. At this point, the 
counter is incremented (assuming positive STEP value) by the 
STEP value. 

The value for the counter is then compared with its final value b. 
As long as the counter's value does not exceed the final value, 
the program will branch back to the statement following the 
FOR statement. This entire process will then be repeated. 

When the counter's value exceeds the specified final value (b), 
the statement following the NEXT statement will be executed. 
This will exit the FOR. .NEXT loop. 

One FOR. .NEXT loop may be placed within another FOR. .NEXT 
loop. This is known as nesting or nested loops. When FOR. .NEXT 
loops are nested, each FOR.. NEXT loop must use a different 
variable name for the counter. Also, the NEXT statement for the 
inside loop must appear before the NEXT statement for the 
outside loop. However, if both loops end at the same point, a 
single NEXT statement may be used to end these. Be certain that 
the variable for the inside loop appears before the variable for 
the outside loop. A NEXT statement such as the following: 

NEXT J, I 

would be interpreted as follows: 

NEXT J 
NEXT I 

Example 

10 FOR X = 1 TO -2 STEP -1 
20 PRINT X 
30 NEXT X 
40 END 
1 RUN [Ret] 

1 

0 

-1 





1 

i 
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In the preceding example, the STEP value is -1 so the counter is 
decremented until its value is -2. 



■ Applesoft 

FRE □ Integer 

The FRE function returns the number of free bytes in memory. 

Configuration 
FRE (argument) 

argument can be any legal expression. It makes no difference 
what the argument is. 

If the amount of free bytes exceeds 32767, the FRE function will 
return a negative number. By adding 65536 to this number, you 
can compute the actual number of free bytes. 

When FRE is used, a housekeeping will be performed before the 
function returns the number of free bytes. Housekeeping is a 
process where BASIC gathers all useful data by freeing any 
memory which was once used for strings, but which is currently 
unused. Memor^for strings becomes unused when the string’s 
length changes. 

Example 



10 A = FRE (0) 

20 IF A < 0 THEN A = A+65536 
30 PRINT "NUMBER OF FREE BYTES IS";A 
40 END 
1 RUN [Ret] 

NUMBER OF FREE BYTES IS 36272 
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GET 



■ Applesoft 
□ Integer 



The GET statement inputs a single character from the keyboard. 
The character is not displayed on the screen. 

Configuration 

GET variable 

variable can be any legal Applesoft variable. 

Although variable can be any variable, it is to the user’s 
advantage to use a string variable and convert it to a numeric 
variable with the VAL function. If a numeric variable was used 
with GET, any non-numeric character entered will cause a syntax 
error and halt program execution. 

Example 



10 PRINT "PRESS A KEY"; 

20 GET A$ 

30 PRINT 

40 PRINT "THE KEY PRESSED WAS";A$ 

50 PRINT 

60 PRINT "IF THE KEY PRESSED WAS NOT A DISPLAYABLE 
CHARACTER IT WOULD NOT BE DISPLAYED" 

70 END 

In the preceding example, line 10 prompts the user to press a 
key. Line 20 waits for a key to be pressed. When a key is pressed, 
the character value of the key is assigned to the variable A$. Line 
40 then displays the character input. Line 60 is included because 
some keys generate characters that cannot be displayed (i.e. 
return key, ESC key and the space bar). 
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■ Applesoft 

GOSUB, RETURN ■ Integer 

The GOSUB, RETURN statements are used to branch to a 
subroutine and then return from it. 

Configuration 

GOSUB line 



RETURN 

line is the first line of a subroutine. In Applesoft, the GOSUB will 
branch to line 0 if line is omitted or an expression is used. In 
Integer BASIC, line can be an expression, where the expression 
evaluates to a line number of a subroutine. 

A subroutine is called by the GOSUB statement. When the 
RETURN statement is encountered within that subroutine, 
program control will branch back to the statement following the 
GOSUB statement just executed. 

Subroutines may appear at any point within the program. 
However, it is good programming practice to group all sub- 
routines near the beginning of the program. 

Example 

10 GOTO 60 
20 PRINT X, 

30 Y = X*X 
40 PRINT Y 
50 RETURN 
60 X=0 

70 FOR I = 1 TO 3 
80 X = X+1 
90 GOSUB 20 

program continued on next page ( 
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100 NEXT I 
110 END 
] RIJN [Ret] 

1 1 

2 4 

3 9 

In the preceding example, line 10 jumps over the subroutine to 
the main program body. When the program reaches line 90, the 
GOSUB is executed. The program branches to line 20. When the 
RETURN in line 50 is reached, program execution jumps back to 
line 100. This process continues until the FOR counter reaches 3. 



GOTO 



■ Applesoft 

■ Integer 



The GOTO statement branches program control to another 
program line. 



Configuration 

1 

GOTO line 

line is the line number of the statement to be branched to. 

Example 

10 PRINT "FIRST" 

20 GOTO 40 
30 PRINT "MIDDLE" 

40 PRINT "LAST" 

50 END 
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GR 



■ Applesoft 

■ Integer 



The GR statement sets and clears the low resolution screen mode 
(40x40 with 4 lines of text at the bottom of the screen). 

Configuration 

GR 

This statement should be executed before the graphics state- 
ments PLOT, HUN.. AT, and VUN..AT are used. 

When the GR statement is executed, the color is automatically 
set to 0 (BLACK). 



Example 

10 GR 

20 COLOR = 15 
30 PLOT 19, 23 
40 END 

The preceding example should put a white square on the screen. 
If line 10 was omitted, a zero would be placed in the middle of 
the screen, because the low-resolution mode was not set. 

If you wish to return to the normal mode, you can do so by 
executing the TEXT statement. 

If full-screen graphics (40x48) is desired, this can be accomplished 
by executing POKE -16302,0 after GR has been executed. POKE 
-16301,0 can be used to restore the text window. 



HCOLOR 



■ Applesoft 
□ Integer 



The HCOLOR statement defines the next color to be displayed 
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by the graphics statements, HPLOT, DRAW, and XDRAW. 
HCOLOR is used in the high resolution graphics mode. 

Configuration 

HCOLOR = number 

number is a numeric expression or numeric constant that 
evaluates to a real number or integer between 0 and 7. Values 
outside this range will produce an error. The colors and their 
associated numbers are shown below. 

0 - Black 1 4 - Black 2 

1 - Green* 5 - Orange (Red)* 

2 - Violet* 6 - Blue* 

3- White 1 7- White 2 

*The actual color depends on the CRT. 

HPLOT, DRAW, and XDRAW will all output lines in the color 
indicated by HCOLOR until a subsequent HCOLOR statement is 
executed. 



■ Applesoft 

HCR □ Integer 

The HGR statement sets and clears the high-resolution graphics 
mode (280x160), with 4 lines of text at the bottom of the screen. 

Configuration 

HGR 

The HGR statement displays page one of the high-resolution 
screen, leaving 4 lines of text at the bottom. If full screen graphics 
(280x192) is preferred, the statement POKE -16302,0 will set the 
rest of the screen to graphics. A POKE -16301$ restores the 4 
lines of text. / 
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Example 

]HGR 

When the preceding example is executed, the high-resolution 
graphics mode will be set and the screen will be cleared to black. 
There will also be four lines of text at the bottom. If the cursor is 
not visible, press the return key until it appears. The cursor may 
not be visible if it is located in the graphics area of the screen 
rather than the text area. 



HGR2 



■ Applesoft 
□ Integer 



HGR2 sets the screen to the high resolution graphics mode 
without the text lines at the bottom of the display (280x192). Page 
2 of high-resolution screen memory is displayed by HGR2. 

Configuration 

HGR2 

In the 80-column mode, HGR2 displays page 1 of screen memory 
rather then page 2. This can be illustrated by running the follow- 
ing example in both the 40 and 80 column modes. It appears that 
this is due to the fact that the Softswitch that activates screen two 
does not work in the 80-column mode. 

Example 



10 

20 

30 

35 

40 

50 



60 

70 



HGR 

HCOLOR = 2 

HPLOT 100,100 TO 150,180 
FOR I =1 TO 1000: NEXT I 
TEXT 

INPUT "PRESS RETURN TO SEE PAGE 2";A$ 
HGR2 

HPLOT 0,0 TO 100,0 
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HIMEM 



■ Applesoft 

■ Integer 



The HIMEM statement defines the address of the highest 
memory location available to a BASIC program. 

Configuration 

HIMEM: number 

number is a numeric constant or numeric expression,. The value 
of number should indicate the highest available memory address. 
This value must lie between -65535 to 65535 (-32767 to 32767 in 
Integer BASIC). 

The current value of HIMEM can be displayed by entering: 



PRINT PEEK (116) *256 + PEEK (115) for Applesoft 
PRINT PEEK (77) *256 + PEEK (76) for Integer BASIC 



If the HIMEM : is set lower than LOMEM or set so low that there is 
not enough room for the program to run, an out of memory 
error will occur. 

HIMEM can only be used in the immediate mode in Integer 
BASIC. 

The value of HIMEM is not changed by the commands NEW, 
CLEAR, RUN, and DEL. 

The HIMEM statement is generally used to reserve memory for a 
machine language subroutine called by the BASIC program. The 
HIMEM statement keeps BASIC variable and array storage 
separate from the machine language subroutine. 
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Example 

HIMEM: 33024 

The preceding example sets high memory to memory address 
33024. Variable and string storage will begin at this address and 
extend downward into memory. 



■ Applesoft 

HLIN ■ Integer 

HLIN is used in the low resolution graphics mode to draw a 
horizontal line on the screen. 

Configuration 

HLIN column 1, column 2 AT row 

column 1, column 2, and row can be either numeric constants or 
numeric expressions, column 1 and column 2 must lie in the 
range of 0 to 39. Also, the value of column 1 must be less than or 
equal to column 2. Row must lie in the range of 0 to 47. 

If an incorrect value is used for column 1, column 2, or row, the 
following error message will be displayed: 

ILLEGAL QUANTITY ERROR 

If HLIN is executed in the text mode, a line of characters rather 
than graphics points will be displayed. Also, if the low resolution 
graphics mode with the text mode is active, and HLIN plots to 
rows 42 to 47, a line of characters will be displayed. 

Example 



10 GR 

20 COLOR = 3 
30 HLIN 0, 39 AT 20 
40 END 
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The preceding example will draw a purple line across the screen 
at row 20. 



HOME 



■ Applesoft 
□ Integer 



The HOME statement clears the screen and places the cursor in 
the upper left hand corner of the screen. 

Configuration 

HOME 

The HOME command is not available in Integer BASIC. The 
cursor can be HOME'd in Integer BASIC by executing CALL-936. 

Example 

HOME 



HPLOT 



■ Applesoft 
□ Integer 



The HPLOT statement can be used to place a dot or draw a line 
on the high resolution graphics screen. The color of the dot must 
have been previously defined by the HCOLOR statement. 

Configuration 

HPLOT column 1, row 1 [TO column 2, row 2 ...] 

HPLOT TO column , row 

column, row, column 1 , column 2, row 1, and row2are numeric 
constants or numeric expressions, column, column 1 , and 
column 2 must lie between 0 and 279. The row, row 1 , and row 2 
must lie between 0 and 191. 
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If the HPLOT is used as shown in the first configuration without 
the optional (TO column 2, row 2), a dot will be plotted. The 
optional TO will connect the two dots. If the column 1 and row 1 
preceding the TO are omitted, the line will be drawn from the 
previous point plotted to the point indicated by column 2, row 2. 

Example 



10 HGR 

20 HCOLOR = 3 
30 HPLOT 0,0 

40 HPLOT TO 0,50 TO 50,50 
50 HPLOT TO 50,0 TO 0,0 



The preceding example will draw a square in the upper left hand 
corner of the screen. 



HTAB 



■ Applesoft 
□ Integer 



The HTAB statement positions the cursor at the location specified 
by its argument . 



Configuration 

HTAB argument 

argument is a numeric constant or numeric expression. The 
argument must be between 1 and 80. 

The cursor will be moved to the position specified by the 
argument. HTAB moves the cursor without erasing any displayed 
characters. 
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Example 

10 PRINT "1234567890" 

20 HTAB 3 : PRINT 3; 

30 HTAB 9 : PRINT 9; 

40 HTAB 5 : PRINT 5 
1 RUN [Ret] 

1234567890 
3 5 9 

In the preceding example, line 20 places the cursor at position 3 
and displays a 3. In line 30, the cursor is moved to position 9. The 
PRINT statement displays a 9. In line 40, HTAB moves the cursor 
back to position 5, and the PRINT statement displays a 5. 



IF..THEN 



■ Applesoft 

■ Integer 



The IF. .THEN statement sets up a condition which will influence 
the program flow. 



Configuration 

IF expression THEN statement [-.statement...] 

expression is a conditional expression, statement can be any 
BASIC statement. 

If the expression is evaluated as true, the THEN portion of the 
statement will be executed. 

In Applesoft BASIC, if the expression evaluates as true, the 
statement following THEN will be executed. If the expression 
evaluates as false, the statement in the next program line will be 
executed. 

In Integer BASIC, if the expression evaluates as true, the 
statement(s) following THEN will be executed. If the expression 
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evaluates as false, the statement immediately following THEN 
will not be executed. Program control will branch to the next 
statement even if that statement is on the same program line as 
the IF, THEN statement. 

For example, if the following statement evaluated as true, 

IF X=15 THEN PRINT "TRUE":PRINT X 

the following would be displayed: 

TRUE 

15 

If this statement evaluated as false, TRUE would not be displayed. 
However, the value for X would be displayed. 

Example 

Applesoft 100 IF X > 8 THEN X = 0 
110 Y = Y+1 

Integer 100 IF X > 8 THEN X = 0 : Y = Y+1 



IN# 



■ Applesoft 

■ Integer 



IN# specifies the peripheral slot which will be providing sub- 
sequent input for the lie. 

Configuration 

IN# argument 

argument is a numeric constant or numeric expression which 
specifies the peripheral slot. The numeric constant must be an 
integer for Integer BASIC. The value of the argument must be 
between 1 and 7. 
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If there is no peripheral in the specified slot, the system will 
hang. Press the Reset key to exit this situation. 

Example 

IN#2 



INT 



■ Applesoft 
□ Integer 



The INT function returns the integer value of the specified 
argument 



Configuration 

INT ( argument ) 

argument is a numeric constant or numeric expression. 

The value returned will always be less than or equal to the 
original value. 



Example 

PRINT INT (1.7), INT (>1.7) 

1 -2 

In the above example, 1.7 is returned as a 1 and -1.7 is returned as 
- 2 . 



■ Applesoft 

INVERSE □ Integer 



The INVERSE statement turns on the INVERSE (reverse) video. 
Following the execution of the INVERSE statement, any charac- 
ters displayed by the computer will be in inverse (i.e. characters 
will be displayed as black characters on a white background.) 
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Configuration 

INVERSE 

The INVERSE mode works by altering the standard ASCII code. 
Therefore, any characters sent to the disk or printer while the 
INVERSE mode is on, may be sent with the incorrect codes. 

The INVERSE statement is equivalent to POKE 50, 127. The 
INVERSE statement can be turned off by the NORMAL statement. 

Example 

] INVERSE 
] PRINT "++" 

++ 



INPUT 



■ Applesoft 

■ Integer 



The INPUT statement accepts data entry from the keyboard or 
another input device while the program is being executed. 

Configuration 

Applesoft INPUT [" message ";] variable [, variable] 

Integer INPUT ["message",] variable [, variable] 

message is a string used as a prompt, variable can be any valid 
BASIC variable. 

When an INPUT statement is executed, program execution will 
stop temporarily. If a prompt was included, the prompt will be 
displayed. In Applesoft, a question mark will be displayed if 
there is no prompt. In Integer BASIC, a question mark will follow 
the prompt if the variable is an integer variable. 
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After the INPUT statement has been executed, the user may 
enter the desired data at the keyboard. That data is assigned to 
the variable(s) listed in the INPUT statement. The number of data 
items entered must equal the number of variables listed. Also, 
the type of data entered must agree with the type specified in 
variable. The data items must be delimited by commas when 
input. 



Example 

Applesoft 10 INPUT "ENTER A NUMBER"; A 
20 PRINT "THE NUMBER IS"; A 
30 END 
1 RUN [Ret] 

ENTER A NUMBER 4.5 
THE NUMBER is 4.5 

Integer 10 INPUT "ENTER A NUMBER", A 
20 PRINT "THE NUMBER IS"; A 
30 END 
> RUN [Ret] 

ENTER A NUMBER? 4 
THE NUMBER IS 4 



LEFT$ 



■ Applesoft 
□ Integer 



The LEFTS function returns the number of characters specified in 
the second expression of the argument to the leftmost of the 
string specified in the first part of the argument. 

Configuration 

LEFTS (a$,x) 

a$ is a string constant searched by the function, x is the number 
of characters to be returned. 
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Integer BASIC can duplicate this function by using string arrays. 

Example 

10 A$ = "ABCDEFG" 

20 PRINT LEFTS (A$, 3) 

30 END 
1 RUN [Ret] 

ABC 

The preceding LEFTS function returned the 3 leftmost characters 
in A$. 

In Integer BASIC, the statement PRINT A$ (1,3) would return the 
same characters. (Be sure that the variable A$ has previously 
been dimensioned to 7 in Integer BASIC.) 



LEN 



■ Applesoft 

■ Integer 



The LEN function returns the number of characters in a string. 

Configuration 

LEN (a$) 



a$ is a string constant. 



Example 



PRINT LEN ("APPLE") 
5 
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LET 



■ Applesoft 

■ Integer 



The LET statement is an optional assignment statement. An 
assignment statement determines the value of an expression and 
then assigns that result to the variable named in the assignment 
statement. 



Configuration 



LET variable = expression 



variable must be of the same data type as the expression. For 
example, if variable is a string, expression must also be a string. If 
variable is an integer or real number, then expression must also 
be numeric. 



Example 



10 LET C = 1+A 
20 L = C*2 



LIST 



■ Applesoft 

■ Integer 



The LIST command is used to list the program stored in memory 
on the video display or other device. 

Configuration 

Applesoft LIST a [{1| [b]] 

or 

LIST[[a]{l|]6 
Integer LIST a [,6] 

a and b are integers greater than or equal to 0. In Applesoft 
BASIC, if a is greater than b, no lines will be listed. In Integer 
BASIC, if b is less than a only line a will be listed. 
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If a is not a line number in the program, the next highest line 
number will be used. If bis not a line number in the program, the 
next lowest line number will be used. 

In Applesoft, a LIST 0 statement will list all the lines in a program. 
For example, LIST 100,0 would list all the lines from line 100 to the 
end of the program. 

In Applesoft, LIST can be frozen by Ctrl-S. Pressing any other key 
will resume LIST. The listing may be stopped by pressing Ctrl-C. 

Example 

LIST 10 [Ret] 

10 GR 

LIST 10,50 [Ret] 

10 GR 

20 POKE -16302,0 
30 COLOR = 3 
40 GOSUB 5000 
50 COLOR =7 



LOAD 



■ Applesoft 

■ Integer 



The LOAD command is used to load a program from a storage 
device to the computer. 



Configuration 



Cassette LOAD 

♦Disk LOAD filename [,D drive] [,V vo/ume][,S s/ot] 

filename is the name of the program, drive is the drive that the 
file is in and volume is the volume number of the diskette, slot is 
the slot the disk interface card is in. 



* LOAD is only interpreted as a BASIC reserved word when used 
with the cassette unit. 
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When using the cassette LOAD, first make sure that the current 
language is active (Applesoft or I nteger BASIC). Position the tape 
to the beginning of the program, type LOAD, and press return. 
The cursor will disappear and after a few seconds the Apple will 
beep. The beep indicates that LOAD has started. When the 
second beep sounds, the LOAD will be finished. If an error 
occurred, turn off the computer, turn it on, and try again. 

In the DOS LOAD, LOAD need only be entered with the 
program name, and the return key pressed. If the indicated file 
name is not present on the specified diskette, the FILE NOT 
FOUND error will occur. 



Example 

LOAD 



LOG 



■ Applesoft 
□ Integer 



The LOG function returns the natural log of the argument. 

Configuration 
LOG (argument) 

argument is a numeric constant or numeric expression greater 
than 0. 

The natural log is undefined for negative numbers. 

Example 

PRINT LOG (25) 

3.21887583 
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LOMEM: 



■ Applesoft 

■ Integer 



The LOMEM statement defines the address of the lowest 
memory location available for BASIC. 

Configuration 

LOMEM: number 

number is a numeric constant or numeric expression. The value 
of number should be the lowest available memory address. This 
value must lie between -65535 to 65535 (-32767 to 32767 in 
Integer BASIC). 

The current value of LOMEM can be displayed by entering 
PRINT PEEK (106) *256 + PEEK (105). 

If LOMEM is set higher than the HIMEM an error will occur. 
LOMEM cannot be set lower than 2048. 

LOMEM can only be used in the immediate mode in Integer 
BASIC. It cannot be used within a program. 

LOMEM cannot be set lower than its current value. LOMEM can 
only be increased. 

LOMEM will be reset by the NEW or DEL commands or by adding 
or changing a line. 



Example 

10 F = PEEK(106) * 256 + PEEK(105) 
20 PRINT "LOMEM IS";F 
30 LOMEM:3000 
40 F = PEEK(106) * 256 + PEEK(105) 
50 PRINT "LOMEM IS NOW";F 
60 END 
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In the preceding example, LOMEM is calculated on line 10 and 
then displayed on line 20. LOMEM is then set to 3000 in line 30. 
Line 0 then recalculates the LOMEM value. The LOMEM setting 
is finally displayed by the PRINT statement in line 50. 



MAN 



□ Applesoft 
■ Integer 



The MAN command is used to turn off the automatic generation 
of program lines. 



Configuration 

/ 

MAN 

When the computer is automatically generating program lines, 
Ctrl-X must be pressed before entering the MAN command. 

Example 

> AUTO 10 [Ret] 

>10 REM TEST [Ret] 

> 20^. Ctrl-X entered by user 

> MAN [Ret] 

In the preceding example, the AUTO was turned off by the 
combination of Ctrl-X and MAN. 



MID$ 



■ Applesoft 
□ Integer 



The MID$ function returns the portion of a string specified by its 
argument. 
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Configuration 

MID$ ( a $ , b[,c]) 

a$ is a string constant, b and c are numeric constants or numeric 
expressions with a value between 0 and 255. b is the first 
character in a$ being returned, c is the number of characters in 
a$ being returned. If c is not included, all characters to the right 
of the position given in b will be returned. 

The MID$ function can be duplicated in Integer BASIC using 
string arrays. 



Example 

10 N$ = "COMPUTER" 

20 PRINT MID$ (N$, 4, 3) 

30 END 
1 RUN [Ret] 

PUT 

In the preceding example, the fourth position in the string N$ is 
the starting position. The 3 indicates 3 characters. This could be 
duplicated in Integer BASIC by using N$(4,6) in place of MID$ 
(N$,1,3). Integer BASIC also requires that the string variable had 
been dimensioned as DIM N$(8). 



NEW 



■ Applesoft 

■ Integer 



The NEW command deletes the program in memory and clears 
all variables. 



Configuration 



NEW 
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The NEW command is generally used to free memory space 
before a new program is entered. 

Example 

> LIST [Retl 
10 TEXT 
20 END 

> NEW [Ret] 

> LIST IRetl 



NORMAL 



■ Applesoft 
□ Integer 



The NORMAL statement turns off the FLASH or INVERSE 
statements. 

! 

Configuration 

NORMAL 

The NORMAL statement sets the video output mode to white 
characters on a black background. The NORMAL statement is 
equivalent to the POKE 50,255 statement. Since NORMAL is not 
available in Integer BASIC, the POKE 50,255 can be used in its 
place. 



Example 

NORMAL 



NOT 



■ Applesoft 

■ Integer 



The NOT function logically compliments the value given in the 
argument. 
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Configuration 

NOT argument 

argument is a numeric constant or numeric expression. In 
Integer BASIC the numeric constant must be an integer. If the 
argument evaluates to true (non-zero), false (zero) will be 
returned. If the argument evaluates to false (zero), true (one) will 
be returned. 



NOT 1 =0 
NOT 0 - 1 

Example 



10 A = 2 

20 IF NOT (A = 1) 

THEN PRINT "A DOES NOT EQUAL ONE" 
30 END 
1 RUN [Ret] 

A DOES NOT EQUAL ONE 



■ Applesoft 

NO TRACE ■ Integer 

The NO TRACE command turns off the TRACE command. 

Configuration 

NO TRACE 

The NO TRACE command may be used as a program statement. 

i Example 



NO TRACE 
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ON 



■ Applesoft 
□ Integer 



The ON statement is used in conjunction with GOTO and 
GOSUB. The statements are used to branch program control to 
one of several program lines depending on the value appearing 
after ON. 



Configuration 

ON exp GOTO line [,//ne ...] 

ON exp GOSUB line [Jine ...] 

exp can be any numeric constant or numeric expression, line is 
the line number the program is to branch to. 

The value of exp controls which line is to be branched to. For 
instance, if exp evaluates to 1, program control will branch to the 
line number given in the first line. If exp evaluates to 2, program 
control will branch to the second line , etc... 

If the ON. ..GOSUB statement is being used, the line number 
specified in line must be that of a subroutine. In other words, a 
RETURN statement eventually will have to be executed to return 
program control. 

If exp evaluates to zero or to a number greater than the number 
of lines specified after GOTO or GOSUB, the program will 
continue with the next executable statement. 

Example 

10 INPUT "ENTER A NUMBER BETWEEN 1 AND 4 ";l 
20 ON I GOTO 60,80,100,120 
30 PRINT 

40 INPUT "PLEASE ENTER A NUMBER BETWEEN 1 AND 4 ";l 
50 GOTO 20 

60 PRINT "YOU ENTERED A ONE" 

70 GOTO 130 

program continued on the next page 
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80 PRINT "YOU ENTERED A TWO" 

90 GOTO 130 

100 PRINT "YOU ENTERED A THREE" 

110 GOTO 130 

120 PRINT "YOU ENTERED A FOUR" 

130 END 

In the preceding example, line 10 prompts the user to enter a 
number between one and four. In line 20, an ON. ..GOTO will 
branch control to a different line depending on the value of I. If I 
is one, program execution will branch to 60. If I is two, program 
execution will branch to 80, etc. If zero or a number greater than 
four was entered, program execution will continue to line 30. 



ONERR GOTO 



■ Applesoft 
□ Integer 



The ONERR statement allows errors to be trapped. The statement 
then transfers program control to an error handling routine at 
the indicated line number. 

Configuration 

ONERR GOTO line 

line is the first line of the error handling routine. ONERR GOTO 
should be executed before the error has occurred. 

When Applesoft executes a program, it executes the program 
line by line. If an error occurs during program execution, 
Applesoft will check to see if an ONERR GOTO statement has 
been executed. If no ONERR GOTO statement had been 
executed, Applesoft will halt program execution and display the 
error. Otherwise the program will branch to the line indicated in 
the ONERR GOTO statement. 

POKE 216,0 turns off any previously executed ONERR GOTO 
statement. 
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To find out what error has occurred, execute PEEK (222). The 
value returned will be the error code. The following list indicates 
the various Applesoft error codes and their respective error 
messages. 



Error Code 


.r Error Message 


0 


NEXT without FOR 


16 


Syntax 


22 


RETURN without GOSUB 


42 


Out of DATA 


53 


Illegal Quantity 


69 


Overflow 


77 


Out of Memory 


90 


Undefined Statement 


107 


Bad Subscript 


120 


Redimensioned Array 


133 


Division by Zero 


163 


Type Mismatch 


176 


String Too Long 


191 


Formula Too Complex 


224 


Undefined Function 


254 


Bad Response to INPUT Statement 


255 


Ctrl C Interrupt Attempted 



For a list of DOS errors and error codes, see Appendix F. 

The RESUME command can be used to return the program to the 
beginning of the statement where the error occurred. 
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Example 

10 ONERR GOTO 1000 
20 INPUT "ENTER A NUMBER"; A 
30 PRINT "A ="; A 
40 END 

1000 E = PEEK (222): REM ERROR CODE 
1010 IF E = 255 THEN END: REM Ctrl-C ENTERED 
1020 IF E = 254 THE PRINT "INVALID ENTRY": RESUME 
1030 IF E= 69 THEN PRINT "NUMBER TOO LARGE/ 

TOO MANY DIGITS": RESUME 
1040 PRINT "ERROR CODE"; E 
1050 END 

]RUN [Ret] 

ENTER A NUMBER ONE [Ret] 

INVALID ENTRY 

ENTER A NUMBER 7E50 [Ret] 

NUMBER TOO LARGE/TOO MANY DIGITS 
ENTER A NUMBERS [Ret] 

A = 5 

In line 10, the ONERR routine is set. When an invalid number was 
entered in response to the INPUT statement in line 20, the 
program branched to line 1000 where E was assigned the proper 
error code. Lines 1010-1030 check the variable E for its value. If E = 
255, then a Ctrl-C was entered. If E =254, an invalid number was 
entered. If E = 69, the number entered was too large or had too 
many digits. Lines 1020 and 1030 incorporate the RESUME 
statement to branch back to line 20. 



OR 



■ Applesoft 

■ Integer 



OR is a logical math operator. This reserved word is generally 
used in conjunction with the IF. ..THEN statement. 
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Configuration 

expression 7 OR expression 2 

expression 1 and expression 2 are Boolean expressions. If the 
expression is numeric (non-zero), it yvill be evaluated to true. A 
zero is treated as false. A truth table for OR is illustrated below. 



X 


Y 


X OR Y 


true 


true 


true 


true 


false 


true 


false 


true 


true 


false 


false 


false 



I n both Applesoft and I nteger BASIC, a true is represented by a 1 
and false by a 0. 

Example 

10 A = 3 
20 B = 5 

30 IF (B < A) OR (B = 5) THEN 50 
40 END 

50 PRINT "EITHER B IS LESS THAN A" 

60 PRINT "OR B IS EQUAL TO 5" 

70 END 

1 RUN [Ret] 

EITHER B IS LESS THAN A 
OR BIS EQUAL TO 5 

In the preceding example, B is not less than A, but B is equal to 5. 
Therefore, the whole OR expression is true, and the program 
branches to line 50. 
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PDL 



■ Applesoft 

■ Integer 



The PDL function returns the value of one of the four different 
game controllers (paddles). 

Configuration 

PDL (argument) 

argument is a numeric constant or numeric expression. The 
numeric constant must be an integer in Integer BASIC. The value 
of the argument must lie between 0 and 255. The value of the 
argument corresponds to the game controller. For example, X = 
PDL(O) returns the position of game controller number zero. The 
number returned will be beteen 0 and 255. 

If the value of the argument is between 4 and 255, the PDL 
function will return an unpredictable number. Using an 
argument between 4 and 255 can also produce unwanted side 
effects which affect program execution. 

Example 

PRINT PDL(O) i 

120 



PEEK 



■ Applesoft 

■ Integer 



The PEEK function returns the contents of the memory address 
given in the argument. 



Configuration 



PEEK ( argument ) 
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argument is a numeric constant or numeric expression between 
-65535 and 65535 (-32767 to 32767 in Integer BASIC). The 
numeric constant must be an integer in Integer BASIC. 

The decimal integer returned by the function will lie between 0 
and 255. 



Example 

PRINT PEEK (-857) 

202 

The preceding example returns the contents of location -857. 



PLOT 



■ Applesoft 

■ Integer 



The PLOT statement plots a dot on the low resolution graphics 
screen. The color of the dot must have been previously defined 
by the COLOR statement. 

Configuration 

PLOT column, row 

column and row must be a numeric constant or a numeric 
expression. The numeric constant must be an integer for Integer 
BASIC, column must lie between 0 and 39 and row must lie 
between 0 and 47. 

The PLOT occurs at the position specified. For example PLOT 3,5 
would place a dot at row five and column three. 

The origin (0,0) is located in the upper left hand corner of the 
screen. 
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If a PLOT statement is executed when the text mode is active a 
character will be placed where the dot should have appeared. 
The same will happen if a PLOT is made in the row range of 40 
and 47 in the mixed graphics-text mode. 

Example 

10 GR 

20 COLOR =3 
30 FOR I = 0 TO 39 
40 PLOT 1,1 
50 NEXT I 
60 END 

The preceding example will draw a diagonal line across the 
screen. 




The POKE statement stores one byte of information in the 
memory location specified. 
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Configuration 

POKE address, value 

address and value are numeric constants or numeric expressions. 
address or value must evaluate to an integer in Integer BASIC. 
address lies between -65535 and 65535 (-32767 and 32767 in 
Integer BASIC.) value must lie between 0 and 255. 

The POKE statement places the indicated value at the specified 
memory address. A POKE has no effect if the address is in ROM 
memory. If a POKE is not used carefully, it can disrupt the lie's 
execution. 



Example 

10 PRINT PEEK(7900) 

20 POKE 7900,37 
30 PRINT PEEK(7900) 

40 POKE 7900,158 
50 PRINT PEEK(7900) 

60 END 

In the preceding example, line 10 first displays what is currently 
in memory location 7900. The value 37 is then poked into 
memory on line 20. Line 30 displays the value at memory location 
7900. The value 158 is then poked into memory and displayed in 
lines 40 and 50. 



POP 



■ Applesoft 

■ Integer 



The POP statement causes a program to ignore the GOSUB or 
ON/GOSUB statement that was executed last. 

Configuration 



POP 
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In effect, a GOSUB or ON/GOSUB statement is converted to a 
GOTO or ON/GOTO statement when POP is executed. The 
program "forgets" that it is in a subroutine. As a result, when a 
POP statement is executed, the next RETURN statement branches 
the program control to the line after the GOSUB statement 
before the previous GOSUB statement. In other words, the 
program "forgets" where the subroutine was called from, so it 
returns to a previous GOSUB statement. 

A POP statement is used, in general, to exit a subroutine. 

Example 



10 X = 5 
20 Y = 10 
30 GOSUB 100 
40 END 
100 PRINT X 

110 IF X > 0 THEN POP:GOTO 130 

120 RETURN 

130 PRINT Y 

140 END 

1 RUN [Ret] 

5 

10 

The previous example contains a program that uses a POP 
statement to exit a subroutine. At line 10, X is assigned the value 
5. At line 20, Y is assigned the value 10. At line 30, the subroutine 
at line 100 is called. 

At line 100, the value of X is displayed. Line 110 is an IF/THEN 
statement that tests the condition X > 0. Since the value of X is 
greater than zero, the condition is true. As a result, the POP 
statement is executed, and the program control branches to line 
130. At line 130, the value of Y is displayed. 
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Since the POP statement was executed, the program is no longer 
in the subroutine. If another RETURN statement is executed, the 
program will not return to line 30, where the subroutine was 
called. The program will return to the line of the previous 
GOSUB statement. Since there is no other GOSUB statement in 
this program, a RETURN statement would cause an error. 

A POP statement can also be used to make the program ignore 
the previous FOR statement. When a POP statement is executed 
within a FOR/NEXT loop, the loop will not be repeated. 
However, an error occurs if a NEXT statement is executed for that 
loop. 



POS 



■ Applesoft 
□ Integer 



The POS function returns the current horizontal position of the 
cursor. 

Configuration 

POS (argument) 

argument can be any legal Applesoft constant or expression. 

The number returned will be ah integer from 0 to 39. The 
leftmost position is 0. 

Example 

]HTAB 7 : PRINT POS(O) 

6 

JPRINT TAB(7); POS(O) 

6 

]PRINT SPC(7); POS(O) 

7 
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In the previous example, the HTAB and TAB functions count the 
leftmost position as 1. The SPC and POS functions treat the 
leftmost position as 0. 



PRINT 



■ Applesoft 

■ Integer 



PRINT is used to display information to the screen or to another 
output device. 

Configuration 

PRINT [expression] [;... [expression]...] 

expression can be any valid numeric or string constant or 
expression. 

expression can include string and numeric variables, as well as 
string and numeric constants. Each variable name or constant 
must be separated by either a comma or a semicolon. When a 
comma separates the items in a PRINT statement, the display is 
divided into three display positions in Applesoft BASIC. These 
begin in columns 1, 17, and 33. In Integer BASIC, the display is 
divided into five fields whose display positions begin at columns 
1,9,17, 25, and 33. 

A PRINT statement can end with a comma, semicolon, or with no 
punctuation at all. A PRINT statement that ends with a semicolon 
causes any subsequent PRINT statement output to appear at the 
next position on the same row of output. 

When a PRINT statement ends with a comma, the next PRINT 
statement output occurs at the next PRINT display position on 
the same row of output. 

When a PRINT statement has no punctuation at the end, the next 
line of output automatically occurs on the next display line. 



* When the 80-column card is active the only two tab positions 
are set (columns 1,9 in Integer; 1,17 in Applesoft). 
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■ Applesoft 

■ Integer 



PR# 



PR# specifies the peripheral slot which will be providing subse- 
quent output for the lie. 



Configuration 

PR# argument 

argument is a numeric constant or numeric expression which 
specifies the peripheral slot. The numeric constant must be an 
integer for Integer BASIC. The value of the argument must be 
between 1 and 7. 

If there is not peripheral in the specified slot the system will 
hang. Press the reset key to exit this situation. 



READ 



■ Applesoft 
□ Integer 



A READ statement is used to assign values to variables. The values 
are taken individually from DATA statements in the order they 
appear in the program. 



Configuration 

READ a r b 

a$ |^b$ ... 

Data items are assigned to variables in the order in which they 
appear in the program unless a RESTORE statement has been 
executed. 

The type of variable in the READ statement must correspond to 
the type of data in the corresponding DATA statement. A 
numeric variable can only be assigned a numeric value. However, 
a string variable can accept any type of character or none at all. 

A program must include at least as many data items as the 
number of variables in its READ statements unless a RESTORE 
statement is executed. 
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Example 

20 READ X,X$ 

30 PRINT X$,X 
40 END 

50 DATA 12, JONES 
1 RUN [Ret] 

JONES 12 

The preceding example contains a program that has a READ 
statement. At line 20, the variables X and X$ are assigned the 
values from the DATA statement at line 50. At line 30, the values 
of the two variables are displayed. 

A READ statement can accept data from a DATA statement that 
appears anywhere in a program. A DATA statement does not 
have to precede the READ statement in order to be effective. 



RECALL 



■ Applesoft 
□ Integer 



RECALL is u§ed to recover a numeric array from cassette tape 
which previously was saved on tape with the STORE statement. 

Configuration 

RECALL array 

It is not necessary to use the same array variable name in the 
RECALL statement that was used in the STORE statement. 
However, that array should be dimensioned with the same 
number of elements in the same dimensions as the array that was 
stored. If the array being recalled was dimensioned with fewer 
elements than the stored array, the following error messge will 
be displayed: 



OUT OF MEMORY ERROR 
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If the array being recalled was dimensioned with more elements 
than the stored array, the values in the recalled array may be in 
the wrong order. 

However, the recalled array may be dimensioned with more 
elements than the stored array if only one final dimension is 
larger. For example, if the stored array was dimensioned as 
follows. 



DIM A(10,10) 

and the recalled array was dimensioned as: 

DIM A(12,10) 

the values recalled would be out of order. 

However, if the recalled array was dimensioned as, 

DIM A(10,12) 

the recalled values would be in the correct order with zeros 
stored in the extra array elements. 

If the recalled array is dimensioned with the same number of 
elements as the stored array but with different dimensions, any 
of the following error messages or error conditions could result: 

ERR OUT OF MEMORY ERROR 

Extra zero values Data out of order 

in the recalled array in the array 

The user is not prompted with cassette operating instructions 
during the execution of either STORE or RECALL. It is a good 
programming practice to precede STORE and RECALL state- 
ments with PRINT statement prompts instructing the operator to 
press the proper cassette recorder keys. 
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The cassette recorder must be in the record mode when STORE 
is executed. The recorder will beep once when recording 
begins, and will beep a second time when it ends. 

The cassette recorder must be in the play mode when RECALL is 
executed. The recorder will beep once when the reading begins 
and a second time when it ends. 



Example* 



1 LOAD STOR1 I Retl 
1LIST fRetl 

5 REM STOR1- STORE EXAMPLE 
10 DIM A(9) 

15 DATA 1,2,3,4,5,6,7,8,9,10 
20 FOR X = 0 TO 9 
30 READ A(X) 

40 NEXT X 

50 INPUT "SET THE RECORDER ON RECORD 
AND PRESS RETURN"; A$ 

60 STORE A 
1 RUN [Ret] 

SET THE RECORDER ON RECORD AND PRESS RETURN 
]NEW [Ret] 1 Press Play & Record on Cassette 

1 LOAD RECAL1 f Retl 
1 LIST [R etl 

5 REM RECAL1- RECALL EXAMPLE 
10 DIM A(9) 

20 INPUT "PRESS PLAY ON THE RECORDER 
AND PRESS RETURN"; A$ 

30 RECALL A 
40 FOR X = 0 TO 9 
50 PRINT A(X) 

60 NEXT 
1 RUN [Ret] 

program continued on the next page 



* This example assumes STOR1 and RECAL1 had previously 
been saved on diskette. 
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PRESS 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

] 



PLAY ON THE RECORDER AND PRESS RETURN 

I Rewind Recorder 
Press Play 



REM 



■ Applesoft 

■ Integer 



A REM statement is used to insert comments in a program. The 
REM statement is ignored by the BASIC interpreter. 

Configuration 

REM remarks 

Example 

REM INPUT ROUTINE 

Any statements that follow a REM statement, on the same line, 
are also ignored by the computer. As a result, a REM statement is 
generally used on its own line or at the end of a multiple 
statement line. 



RESTORE 



■ Applesoft 
□ Integer 



A RESTORE statement is used to move the DATA statement 
pointer to the beginning of the DATA item list. 
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Configuration 

RESTORE 

The data in a program is read in order, starting with the first 
DATA statement item. In order to reread the data, a RESTORE 
statement is necessary. 

When a RESTORE statement is executed, the next READ state- 
ment will assign, to its first variable the first data value that 
appears in the program. 



Example 



10 

20 

30 

40 

50 

60 

70 

80 

90 

100 

110 



READ A1,B1,C1,X1$ 

PRINT A1,B1,C1 
PRINT X1$ 

RESTORE 

PRINT 

READ A2,B2,C2,X2$ 

PRINT A2,B2,C2 
PRINT X2$ 

READ X3$ 

PRINT X3$ 

DATA 32, -102,2.12, RECTOR,SPALL 



In the preceding example, data is read into the variables 
indicated in line 10. The data is then displayed in lines 20 and 30. 
The RESTORE statement in line 40 allows the data items read in 
line 10 to be read again. 



RESUME 



■ Applesoft 
□ Integer 



RESUME is used in Applesoft BASIC to resume program exe- 
cution after an ONERR GOTO statement has branched program 
control to an error routine. 
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Configuration 

RESUME 

If RESUME is executed without an error having previously 
occurred, the program will stop, the system will hang, or an error 
message may result. 



RETURN 



■ Applesoft 
□ Integer 



A RETURN statement is used to branch a program back to the 
line where the last subroutine was called. 

Configuration 

RETURN 

A subroutine is called with a GOSUB or ON/GOSUB statement. 
When the subroutine has been completed, a RETURN statement 
causes program control to return to the statement following the 
most recently executed GOSUB or ON/GOSUB statement. 

Example 

RETURN 



RIGHTS 



■ Applesoft 
□ Integer 



The RIGHTS statement is used to return the rightmost characters 
of a string. 



Configuration 

65 = RIGHTS (aS,c) 
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The RIGHTS function returns a string value. The first argument is 
a string constant or a string variable. The second argument is a 
numeric value. The string returned consists of the number of 
characters specified by the numeric argument. These characters 
are the rightmost characters in the string argument. 

Example 

10 A$ = "WILLIAM JONES" 

20 PRINT A$ 

30 PRINT RIGHT$(A$,5) 

1 RUN [Ret] 

WILLIAM JONES 
JONES 

The preceding example contains a program that uses a RIGHTS 
statement. At line 10, the string variable A$ is assigned the value 
"WILLIAM JONES". At line 20, the value of A$ is printed. At line 
30, the rightmost 5 characters of the value of A$ are displayed. 

If the value of the numeric argument exceeds the length of the 
string argument, the entire string value is returned. If the value 
of the numeric argument is less than one or greater than 255, the 
following error message will be displayed: 

ILLEGAL QUANTITY ERROR 



■ Applesoft 

RND ■ Integer 

The RND function is used to generate "random" numbers. 

Configuration 

X = RND (a) 

In Applesoft BASIC, RND will return a random number greater 
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than or equal to zero and less than one. If RND's argument (a) is 
positive, a new random number will be generated each time 
RND is executed. 

RND can also be used with a negative argument. The same 
random number will be returned when RND is executed with 
the same negative value for a. 

If the same negative argument is repeated followed by RND 
statements with positive arguments, the same series of random 
numbers will be generated. This is illustrated in the following 
example. 



Example 

100 PRINT RND (-1) 

200 PRINT RND (3) 

300 PRINT RND (.22) 

400 PRINT RND (.33) 

500 PRINT RND (-1) 

600 PRINT RND (.99) 

700 PRINT RND (2.7) 

800 PRINT RND (.77) 

1 RUN [Ret] 

2.99196472E-08 

.738107502 

.272707136 

.299733446 

2.99196472E-08 

.738207502 

.272707136 

.299733446 

In Applesoft BASIC, if a = 0, RND will return the most recently 
generated random number. 

In Integer BASIC, RND returns a random integer with a value 
greater than or equal to zero but less than a. 
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ROT= 



■ Applesoft 
□ Integer 



ROT= sets the amount of rotation for a shape which is to be 
drawn with either DRAW or XDRAW. 

Configuration 

ROT=x 

x can range from 0 through 255. The shape will be rotated 90 
degrees clockwise for every increment of 16 in the value of x. For 
example, ROT=0 causes the shape to be drawn in the same 
position in which it was originally defined. ROT=16 causes the 
shape to be rotated 90° clockwise. ROT=32 causes the shape to 
be drawn upside down. ROT=64 causes the shape to be drawn in 
its original position. 

The number of actual different rotations is limited by the SCALE= 
setting. Lower SCALE= settings will have fewer noticeable 
rotations. When SCALE= is set to one, there are only eight 
noticeable ROT= values. They are 0,8,16,24,32,40,48,56 and 
numbers greater than 63 which would use the MOD64 equi- 
valent. If a number other than 0,8,16,24,32,40,48, or 56 is used, the 
shape will generally be drawn with the lower corresponding 
ROT= value. 

ROT= is only regarded as a reserved word if the equal sign (=) is 
placed immediately following ROT without any intervening 
blanks, spaces or characters. 

Example 

ROT=32 

The ROT= statement given in our example would cause a shape 
previously defined by DRAW or XDRAW to be rotated 180 
degrees. 
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RUN 



■ Applesoft 

■ Integer 



RUN is used to execute the BASIC program currently stored in 
memory. Prior to program execution, all variables, pointers, and 
stacks will be cleared. 



Configuration 

RUN [linenumber] 

If linenumber is specified, execution will begin at the specified 
line. If no linenumber is specified, execution will begin with the 
lowest line number. If a non-existent linenumber is specified, 
one of the following error messages will result: 

***BAD BRANCH ERR Integer 
?UNDEF'D STATEMENT ERROR Applesoft 

In Integer BASIC, RUN can only be executed in the immediate 
mode. 



SAVE 



■ Applesoft 

■ Integer 



The SAVE command is used to store a program on diskette or 
cassette. 

Configuration 

Cassette SAVE 

Diskette SAVE filename [Dx] [,Vx] [,Sx] 

When using the cassette SAVE, the cassette recorder's Play and 
Record keys must be depressed when SAVE is executed. 

The lie will beep when it begins to save the program and will 
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beep a second time when the recording has been completed. At 
this time, the operator should stop the cassette recorder. 

SAVE is only interpreted as a BASIC reserved word when used 
with the cassette unit. 

In the DOS SAVE, SAVE need only be entered with the program's 
filename and the return key pressed. If the indicated filename 
duplicates that of a file in the same language already on the 
diskette, the contents of the original program will be erased and 
replaced with the new program. If the indicated filename 
duplicates that of a file in a different language or with a different 
file type, the following message will be displayed: 

FILE TYPE MISMATCH 

Example 

SAVE 



SCALE= 



■ Applesoft 
□ Integer 



SCALE= is used to set the size of shapes drawn by DRAW or 
XDRAW in high resolution graphics. 

Configuration 

SCALE=x 

The integer value of x is multiplied by the size of the shape table. 
Therefore, when SCALE=1, a shape is drawn with the same scale 
as that with which it was defined. SCALE=2 causes the shape to be 
drawn at twice its defined size, etc. SCALE=0 causes the shape to 
be drawn at 256 times its defined size. 
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Example 

10 REM SET UP SCREEN 

20 TEXT:HGR 

30 FOR X = 7936 TO 7946 

40 READ V:REM READ IN SHAPE 

50 POKE X,V:REM POKE SHAPE INTO MEMORY 

60 NEXT X 

70 REM TELL WHERE SHAPE IS AT 
80 POKE 232,0: POKE 233,31 
90 HCOLOR = 3 
100 ROT = 0 

110 FOR X = 10 TO 273 STEP 24 
120 INPUT "ENTER SCALE ";S 
130 IF S < 1 THEN X = 273: GOTO 160 
140 IF S > 50 THEN X = 273: GOTO 160 
150 SCALE = S: DRAW 1 AT X,100 
160 NEXT X 

170 DATA 1,0,4,0,39,36,45,53,54,63,0 
180 END 

In the preceding example, line 20 initialized the screen so that 
graphics could be drawn. The shape table was then read using 
the FOR NEXT loop in lines 30 to 60. Line 80 POKE’d the starting 
address of the shape. Lines 90 and 100 defined a color and 
rotation for the shape. Lines 110 to 160 then prompted the user to 
enter a scale size. The number entered will be the size of the next 
shape drawn on the screen. The program will then exit after the 
entry of eleven sizes or when the value entered is less than one 
or greater than fifty. 



SCRN 



■ Applesoft 

■ Integer 



SCRN is used in the low resolution graphics mode to return the 
color code of the point specified as its argument. 




Apple BASIC Reference Guide 153 



Configuration 

SCRN (x,y) 

x and y can range from 0 to 47. If x is in the range from 0 to 39, 
SCRN will return the color code of the point whose column is 
indicated by x and whose row is indicated by y. 

If x is in the range from 40-47 and y is in the range from 0-31, 
SCRN will return the color of the point whose column is equal to 
x-40 and whose row is equal to y+16. 

If x is in the range from 40-47 and y+16 is in the range from 39-47, 
SCRN will return a number related to the text character in the 
text area before the graphics screen. If y+16 is in the range 48-63, 
SCRN will return a meaningless number. 

When x is in the range 0-39 and y is in the range 0-23, the 
following expression will return the ASCII code of the character 
at that position. 

SCRN (a, 2*6) + 16*SCRN (a, 2*6+1) 

The character itself will be returned when the CHR$ function is 
executed using the value returned by the above expression as its 
argument. 

When SCRN is executed in the high resolution graphics mode, 
SCRN will continue evaluating the low resolution area of 
memory. The value returned by SCRN will have no relation to 
the high resolution screen. 

SCRN is only regarded as a reserved word when the next non- 
space character is the left parenthesis. 
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Example 



10 GR 

20 COLOR = 2 
30 PLOT 20,10 
40 COLOR =6 
50 PLOT 30,35 

60 PRINT SCRN(20,10), SCRN(30,35), SCRN(10,0) 

70 END 

In the preceding example, line 10 initializes the low resolution 
screen. Lines 20 to 50 plot two different colored dots on the 
screen. Line 60 displays the color value of the corresponding 
dots. Notice that the value of SCRN(10,0) is zero. There is a black 
dot at that position. 



SCN 



■ Applesoft 

■ Integer 



The SGN function returns a +1 if its argument is positive, a -1 if 
negative, and a 0 if zero. 

i Configuration 

SGN (a) 

Example 

100 A = 100 
200 X = SGN(A) 

300 PRINT X 
400 END 
1 RUN [Ret] 

1 
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SHLOAD 



■ Applesoft 
□ Integer 



SHLOAD is used in Applesoft BASIC to load a high resolution 
shape table into memory from cassette tape. 

Configuration 

SHLOAD 

The shape table will be loaded in memory immediately below 
HIMEM. HIMEM will be set just underneath the shape table in 
order to protect it. 

Be certain that HIMEM: has been set so that the execution of 
SHLOAD will not erase any programs or variables. 



SIN 



■ Applesoft 
□ Integer 



The SIN function returns the sine of the angle specified as its 
argument. The argument will be assumed in radians. 

Configuration 



X = SIN (a) 

Example 

PRINT SIN (3.1415927/2) 
.999999992 
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■ Applesoft 

SPC □ Integer 

The SPC statement is used to insert spaces in a PRINT statement. 

Configuration 

SPC (a) 

The argument of the SPC statement specifies the number of 
blank spaces that will occur. 

Example 

10 X = 4 
20 Y = 6 

30 PRINT X;SPC(5);Y 
40 END 
1 RUN [Ret] 

4 6 

In the previous example, the values of the variables X and Y are 
printed at line 30. The SPC statement within the PRINT statement 
causes the output to be separated by 5 extra spaces. 



■ Applesoft 

SPEED □ Integer 

The SPEED statement sets the speed at which characters are 
output. 



Configuration 

SPEED =x 

xcan range from 0 to 255, with 0 being the slowest speed and 255 
the fastest. 
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SQR 



■ Applesoft 
□ Integer 



SQR returns the square root of its argument. 

Configuration 
SQR (a) 

Example 



10 X=49 
20 PRINT SQR (X) 
1 RUN [Ret] 

7 



■ Applesoft 

STOP □ Integer 

The STOP statement causes a halt in the execution of an 
Applesoft BASIC program. 

Configuration 

STOP 

If STOP is executed in the program mode, the following screen 
message will be displayed, 

BREAK IN XXX 

where XXX is line number where STOP was executed. 

CONT can be used to rescue program execution after it was 
halted by the execution of a STOP statement. 






158 Apple lie Users Handbook 



Example 

10 INPUT X 

20 IF X = 10 THEN STOP 
30 PRINT X 
40 END 

In the preceding example, if a value of 10 is input for X in line 10, 
the program execution will stop and the following message will 
be displayed. 



BREAK IN 20 

By entering CONT, program execution will resume with line 30. 



STORE 



■ Applesoft 
□ Integer 



The STORE statement is used to save an Applesoft array on 
cassette tape. STORE is generally used in conjunction with the 
RECALL statement. 



Configuration 

STORE array 

For an explanation of STORE please refertoRECALLon page141. 



STR$ 



■ Applesoft 
□ Integer 



STR$ returns the string representation of its argument. 

Configuration 
X$ = STR$(a) 
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Example 

10 A$ = STR$(40) 

20 PRINT A$ 

30 END 
1 RUN [Ret] 

40 

In the preceding example, the string variable A$ is assigned the 
string value "40". The STR$ function converts the numeric value 
40, to the string value "40". 



TAB 



■ Applesoft 
□ Integer 



In Applesoft BASIC, the TAB function moves the cursor to the 
right to the column specified as its argument. TAB must be used 
with a PRINT statement in Applesoft BASIC 

Configuration 

TAB (column) 

TAB erases existing screen data as it moves to the right. If the 
specified column is not to the right of the current column 
position, the cursor will not move. 

column can range from 1 to 255. If column is greater than that 
allowed for the output device (80 for video display), the cursor 
will move down to the next output line before tabbing will 
continue. 
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10 X = 1:Y = 2 
20 PRINT 
30 PRINT X; 

40 PRINT TAB(120); 

50 PRINT Y 
60 END 

In the preceding example, X is output at the leftmost column of 
the display line. TAB then moves the current print position to the 
middle of the next display line where Y is output. In Applesoft 
the TAB statement after produces erratic results if it is not the first 
item in the PRINT statement output list. 



TAB 



□ Applesoft 
■ Integer 



In Integer BASIC, TAB positions the cursor at the specified 
column on the display line where the cursor is located. 

Configuration 

TAB column 

In Integer BASIC, the cursor will be moved to the left or right 
depending on the value of column and the current cursor 
position, column can range from 1 to 255. Existing screen data is 
not erased if TAB causes the cursor to move over that data. 

Example 



10 PRINT 
20 X = 1 :Y = 2 

30 PRINT X:TAB 20:PRINT Y:TAB 10.PRINT Y 
40 END 
> RUN [Ret] 

1 



2 



2 
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TAN 



■ Applesoft 
□ Integer 



TAN returns the tangent of its argument in radians. 

Configuration 
a =TAN(b) 

Example 

10 A = TAN(35*3.141593/180) 

20 PRINT A 
1 RUN [Ret] 

.700207639 



■ Applesoft 

TEXT ■ Integer 

TEXT returns the screen to the text mode from any of the 
graphics modes. 



Configuration 

TEXT 

TEXT does not necessarily clear the screen. 



TRACE 



■ Applesoft 

■ Integer 



TRACE displays the line number of each statement as it is 
executed. Generally, TRACE is used as a debugging tool. 
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Configuration 

TRACE 

TRACE can be turned off by executing NO TRACE. 



USft 



■ Applesoft 
□ Integer 



USR passes program control to a machine language subroutine. 
USR's argument is evaluated and then placed in the floating 
point accumulator (9DH and A3H). A USR is then undertaken to 
OAH, which is the subroutine's starting address. 

Addresses OAH to OCH must contain a JMP to the starting address 
of the machine language subroutine. 

Since USR is a function, it returns a numeric value. The value in 
the accumulator is returned when an RTS instruction is executed. 

Example 

10 POKE 10,76 : POKE 11,0 : POKE 12,32 

20 FOR X= 8192 TO 8198 

30 READ V 

40 POKE X,V 

50 NEXT X 

60 FOR X = 1 TO 4 

70 PRINT X, USR(X) 

80 NEXT X 

90 DATA 165,157,105,3,133,157,96 
100 END 

In the preceding example, line 10 pokes the location of the 
machine language program to be executed. Lines 20 to 40 place 
the program in memory. Lines 60 to 80 then make use of the 
machine language program. The USR in this example multiplies 
the argument by 16. 
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VAL 



■ Applesoft 
□ Integer 



The VAL function converts its string argument to a numeric 
value. The numeric characters in the string argument will be 
converted to their numeric equivalents until an unacceptable 
string character is encountered. The acceptable characters 
consist of the digits (0-9), the decimal point, a leading plus or 
minus sign, blank spaces, and in scientific notation an additional 
plus or minus sign, the letter E (for exponent), and an additional 
decimal point. 

If the first character encountered by VAL is an unacceptable 
character, a value of zero is returned. 

Configuration 

VAL (a$) 

Example 

10 A$ = "1.731 E+02" 

20 B$ = "+97.5" 

30 C$ = "57CA" 

35 D$ = "E59" 

40 PRINT VAL(A$) 

50 PRINT VAL(B$) 

60 PRINT VAL(C$) 

70 PRINT VAL(D$) 

1 RUN [Ret] 

173.1 

97.5 

57 

0 



VUN 



■ Applesoft 

■ Integer 



VLIN is used to draw a vertical line in low-resolution graphics. 
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Configuration 

VUN row 7, row 2 AT column 

A vertical line will be drawn at the specified column from row 1 
to row 2. The color of the line will be determined by that 
specified in the last COLOR statement executed. 

row 1 and row 2 must be in the range of 0 to 47. column must lie 
in the range 0 to 79. If a value outside of these ranges is used, the 
following error message will be displayed: 

ILLEGAL QUANTITY ERROR 

If VLIN is executed in the text mode, then a line of characters will 
be displayed rather than a line of graphics dots. This also occurs 
in the text window in the GR mode. 

Example 



10 GR 

12 COLOR = 3 
15 FOR I =1 TO 20 
20 VLIN 10,30 AT I 
25 NEXT I 
30 END 



■ Applesoft 

VTAB ■ Integer 

VTAB moves the cursor to the indicated row on the screen. VTAB 
causes the cursor to move up and down but never sideways. 

Configuration 

VTAB row 

row can range from 1 to 24. A row value outside of that range 
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results in the following error message: 

ILLEGAL QUANTITY ERROR 



Example 

5 HOME : REM CALL -936 
10 PRINT "ROW 1" 

20 VTAB 2: PRINT "ROW 2" 

30 VTAB 10: PRINT "ROW 10" 
40 VTAB 20: PRINT "ROW 20" 
50 END 



■ Applesoft 

WAIT □ Integer 



WAIT can be used to suspend operation of an Applesoft BASIC 
program until a designated memory address is assigned a 
specified value. 



Configuration 

WAIT address, value 1, [value 2] 

address specifies the memory address whose value is to be 
decided, value 1 and value 2 are compared with address to 
determine whether the program proceeds or continues to wait. 

address can range from -65535 to 65535. value 1 and value 2 can 
range from 0 to 255. When WAIT is executed, value 1 and value 2 
are converted to their binary equivalent in the range from 0 
through 11111111. 

When address and value 1 are the only arguments indicated with 
WAIT, each of the eight bits in address are AND'ed with each 
corresponding bit in the binary equivalent of value 7. If the result 
of the AND operation is non-zero for any one bit (the bit had a 
value of 1 in both address and value 7), the WAIT statement will 
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be completed and execution will be resumed. Otherwise, this 
test will continue until a non-zero value is returned. 

When value 2 is also specified, a two-part comparison process is 
used. First of all, each of the eight bits at address are XOR'ed with 
the corresponding bit in value 2’s binary equivalent. Second, the 
result of the XOR comparison is AND’ed with the corresponding 
bit in value 1’s binary equivalent. If a non-zero value is returned 
for any comparison, the program will proceed. Otherwise, the 
test will continue. 



Example 

10 REM SET ADDRESS FOR GAME CONTROL 0 TO 0 
20 POKE 49168,0 

30 PRINT "THE PROGRAM HAS STARTED" 

40 PRINT:PRINT 

50 PRINT "EXECUTION WILL BE HALTED UNTIL 
THE BUTTON ON GAME CONTROL 0 IS PRESSED" 
60 PRINT:PRINT 
70 WAIT -16287,128 

80 PRINT "THE BUTTON WAS PRESSED" 

90 PRINT "THE PROGRAM WILL NOW END" 



XDRAW 



■ Applesoft 
□ Integer 



XDRAW is used to draw a graphics shape in high resolution 
graphics. 



Configuration 

XDRAW shape [AT column, row] 

The color, scale, and rotation of the shape to be drawn must have 
been specified previously, shape denotes the number from the 
shape table of the shape to be drawn, shape must have a value 
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between 0 and the number of shapes in the table. The optional 
column and row denote the starting x and y coordinates for the 
shape. 

XDRAW uses the color which is the compliment of the color 
which already exists at each point being plotted. The com- 
plementary colors are as follows: 

O(Black) — 3(White) 

1 (Green) — 2(Violet) 

4(Black) — 7(White) 

5(Orange) — 6(Blue) 

One other feature of XDRAW is that it allows a shape to be easily 
erased. If a shape is XDRAWn and then XDRAWn again with the 
same parameters, the shape will be erased without erasing the 
background. 



Example 

10 REM SET UP SCREEN 

20 TEXT:HGR 

30 FOR X= 7936 TO 7946 

40 READ V:REM READ IN SHAPE 

50 POKE X,V:REM POKE SHAPE INTO MEMORY 

60 NEXT X 

70 REM TELL WHERE SHAPE IS AT 
80 POKE 232,0: POKE 233,31 
90 REM PUT UP A BACKGROUND 
100 HCOLOR = 3 

110 HPLOT 20,20 TO 60,20 TO 20,70 
120 PRINT "BACKGROUND SET UP" 

130 INPUT "PRESS RETURN TO DISPLAY SHAPES";A$ 

140 ROT = 0 

150 SCALE = 10 

160 XDRAW 1 AT 50,30 

170 SCALE = 6 

180 ROT = 4 

190 XDRAW 1 AT 20,70 

program continued on next page 
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200 INPUT "PRESS RETURN TO ERASE SHAPES";A$ 

210 XDRAW 1 AT 20,70 

220 SCALE =10 

230 ROT = 0 

240 XDRAW 1 AT 50,30 

250 DATA 1,0,4,0,39,36,45,53,54,63,0 

260 END 

In the preceding example, line 20 initialized the screen so that 
graphics could be drawn. The shape is then read in the FOR 
NEXT loop in lines 30 to 60. Since Applesoft needs to know where 
the shape was placed, the shape address is POKE'd into memory 
in line 80. 

A color is defined in line 100. The color definition is only 
necessary for the background, which consists of two lines. 
XDRAW does not need to define the color, however the size and 
the rotation should be defined. These are defined on lines 140, 
150, 170, 180, 220 and 230. 

The two shapes, with different sizes, rotations, and positions, are 
then XDRAW'n to the screen in lines 160 and 190. Notice that the 
shapes were drawn over the background (two lines). The two 
shapes were then drawn again over the previous shapes in lines 
210 and 240. Because XDRAW plots the compliment of the color 
that is on the screen, it will erase the previous shape and keep the 
background intact. 



\ 

( 




CHAPTER 5. CASSETTE AND DISK 
STORAGE WITH THE APPLE lie 



Introduction 

Generally, a disk drive is used for storage with the Apple lie. 
However, a cassette recorder can also be used with the lie for 
data storage. In this chapter, we will discuss cassette storage 
procedures followed by disk storage procedures. 

If you are using the cassette recorder rather than the disk unit for 
data storage, keep the following points in mind: 

• DOS is not available when using the cassette. 
Applesoft and the Monitor are the only 
available systems software. 

• Since Integer BASIC is loaded from diskette, it is 
not available on cassette. Therefore, Integer 
BASIC programs cannot be loaded and run 
from cassette. 

CASSETTE INSTALLATION & OPERATION 

Nearly any standard cassette recorder can be used with the lie. 
The cassette unit is installed by attaching a double cable (or two 
individual cables) from the cassette in and out jacks at the rear of 
the lie to the jacks on the cassette recorder. One cable should 
connect the cassette input jack on the lie to the earphone or 
monitor jack on the cassette recorder. The other cable should 
connect the lie’s cassette output jack to the cassette recorder’s 
microphone jack. 

The cassette unit is operated in much the same manner with the 
lie to record data as it is used to record sound. The play and 
record keys must be depressed to save data on the cassette. The 
play key must be depressed when data is to be read from the 
cassette into RAM. The rewind and fast forward keys are used to 
position the tape. 
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You may find it necessary to adjust the tone and volume controls 
in order for the cassette to properly record data. The easiest 
means of doing this is to try saving and reloading a program. If 
the program can be saved and then reloaded without any 
difficulties, the volume and tone controls are adjusted properly. 
If one of the following error messages appears: 

ERR 

♦♦♦SYNTAX ERR 

set the volume control higher and again attempt the saving and 
loading process. 

SAVING & LOADING A PROGRAM ON CASSETTE 

The SAVE command is used to save a program from RAM to the 
cassette recorder. Prior to executing SAVE, be certain that a 
cassette has been placed in the cassette recorder and that the 
tape has been positioned as desired. Then, press the recorder's 
play and record keys and enter the following command at the 
keyboard: 



SAVE [Ret]* 

The Apple lie will beep once as it begins recording the program 
on tape, and will beep a second time when the recording process 
has been completed. After the second beep, press the recorder's 
stop key. 



♦[Ret] indicates that the return key should be pressed. 
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If you wish to load a program from cassette tape into RAM, first 
of all enter NEW in order to erase any existing program lines 
from memory. Be certain that the tape has been rewound to the 
beginning point of the program to be loaded. Press the re- 
corder’s play key, and enter the following command: 

LOAD 

The Apple lie will beep once as the loading process begins and a 
second time when it ends. After the second beep, press the 
recorder's stop key. You can verify the fact that the program has 
been loaded by executing LIST. 

Storing & Loading Data on Cassette 

Numeric arrays can be stored and loaded on cassette using 
Applesoft’s STORE and RECALL statements. These are discussed 
in detail in Chapter 4. 

The Monitor’s memory write and memory read commands can 
also be used to store and read data to and from tape. These will 
be discussed in detail in Chapter 7. 

Apple lie Disk Storage 

A disk drive can also be used with the Apple lie to store data 
and/or programs. Disk storage is much more efficient than 
cassette tape storage. The majority of 1 le owners are expected to 
use disk drives as their primary means of data storage. 

TYPES OF DISKS 

There are three primary types of disks used by personal 
computers; hard disks, Winchester disks, and floppy diskettes. 
These will be described in the following sections. 

Hard Disks 

Microcomputer hard disk systems generally allow storage of 5 to 
30 megabytes of data. One megabyte is the equivalent of one 
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million bytes. The hard disk itself is made of a rigid material with 
a magnetic coating. The disk drive and the hard disk are separate 
units. The operator can remove one hard disk and replace it with 
another. 

Winchester Disk Drives 

Winchester disk drives are designed so that from 6 to 10 times 
more data can be stored on their surface than on a standard 
floppy diskette. Winchester disks must be kept very clean as they 
are extremely vulnerable to dust, dirt and smoke. 

Since they must be kept so clean, Winchester disks must be 
sealed inside of the disk drive. This means that Winchester disks 
cannot be changed. 

Since Winchester disks cannot be removed, floppy disk systems 
often are used in conjunction with Winchester disks to allow for 
back-up storage. Winchester disk systems are generally used 
with microcomputers rather than hard disk systems. A Win- 
chester drive is shown in Illustration 5-1. 
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Illustration 5-1. Winchester Disk System 




Floppy Diskettes 

The most widely used type of disk storage with microcomputers 
is floppy disk storage. The Disk II Drive (used with the lie) is a 
floppy disk drive. A floppy diskette consists of a round vinyl disk 
which is enclosed within a plastic cover. The diskette is generally 
stored in a diskette envelope. 

This cover protects the diskette from damage while it is being 
handled by the operator. The diskette should never be removed 
from its cover. A 514 inch diskette with its protective envelope is 
shown in Illustration 5-2. 

The diskette is allowed to rotate within the protective envelope. 
The round hole in the middle of the diskette allows the disk drive 
to hold the diskette and spin it. The oblong shaped opening on 
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the protective envelope provides an area where the head can 
read from or write to the diskette surface. 

Illustration 5-2. Mini-Floppy Diskette 




Floppy diskettes come in two sizes: 8 inch and 514 inch. The 514 
inch diskettes are also known as mini-floppy diskettes. Apple's 
Disk II drives use mini-floppy diskettes. 

Tracks and Sectors 

To facilitate the process of searching for data on the diskette 
surface, that surface is divided into tracks and sectors. 

Tracks may be visualized as a series of concentric circles on the 
diskette surface, as shown in Illustration 5-3. 



§ 

Cassette and Disk Storage with the Apple lie 175 



Illustration 5-3. Tracks and Sectors 




A 

In Apple's Disk II system, the diskette is divided into 35 different 
tracks. 

To further reduce the time necessary to search for a particular 
data item, Apple's DOS* divides each track into 16 sectors (see 
Illustration 5-3.) 

Each sector can store up to 256 bytes of information. When the 
Disk M's read/write head* is in place over a specific track, that 
track's 16 sectors will pass one by one underneath the read/write 
head as the diskette rotates. 

Whenever DOS reads or writes information from the diskette, it 
does so in groups of 256 bytes. In other words, data is read from 
or written to the diskette one sector at a time. 



*DOS stands for disk operating system which will be explained in 
detail later. 



"N 
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Hard and Soft Sectoring 

Locating a particular track on the disk surface is a relatively 
uncomplicated matter. The drive merely moves the head to the 
position on the? diskette where the specified track is located, 
much like the needle on a phonograph is positioned to the 
location of a specific song on a record album. 

However, locating a particular sector is a more difficult process. 
Two different methods are used to locate sectors on a disk; hard 
sectoring and soft sectoring. 

Both the hard and soft sector methods involve the use of an 
index hole. The index hole is shown in Illustration 5-2. It is 
located just to the right of the large hole in the middle of the 5 Va 
inch diskette. 

The index hole as shown in Illustration 5-2 is a hole only in the 
diskette's protective covering. Another index hole is located on 
the actual diskette surface inside the envelope. As the diskette 
spins, the index hole (or holes) on the diskette surface passes 
underneath the hole in the protective envelope. 

A light source inside the disk drive shines light onto the area of 
the diskette containing the index hole. When an index hole on 
the disk surface is aligned with the index hole on the protective 
envelope, the light will shine through to a sensor. The sensor will 
relay information on the location of the index holes, which can 
be used to calculate the various sector locations. 

Now that we have discussed the concepts of locating sectors, we 
will discuss the difference between hard and soft sectored 
diskettes. A hard sectored diskette contains a number of holes, 
each of which indicates the location of a sector. An extra hole is 
used to indicate the location of the first sector. The location of 



*The disk drive contains a device known as a read/write head, 
which is used to read and write information. The computer can 
move the head to any position desired on the disk surface. 
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the various sectors is determined by counting the number of 
holes occuring after the first sector. A hard sectored diskette is 
depicted in Illustration 5-4. 

Soft sectored diskettes have only one index hole as shown in 
Illustration 5-5. This solitary index hole marks the location of the 
first sector. By timing the rotation speed of the floppy diskette, 
the location of the other sectors can be determined. The Apple 
lie Disk System uses soft-sectored diskettes. 

Illustration 5-4. Hard Sectored Diskette 




Illustration 5-5. Soft Sectored Diskette 




Sector 
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Single and Double Sided Diskettes 

Some floppy diskettes are designed to be written on only one 
side. These are known as single sided (SS) diskettes. 

Diskettes which are designed to be written on both sides are 
known as double sided (DS) diskettes. 

Single, Double, and Quad Density Diskettes 

Density refers to a diskette's recording format, which in turn 
affects its capacity. Double density diskettes generally have a 
greater recording capacity than single density diskettes, while 
quad density diskettes generally have a greater capacity than 
either single or double. 

The Apple lie Disk Drive uses double-density diskettes with a 
capacity of 143,250 bytes. 

Diskette Write Protection. 

Diskettes have a notch on the side of their protective envelope 
which determines whether or not data can be written onto that 
diskette. On 8 inch diskettes, this notch is known as a write- 
protect notch. On 514 inch diskettes, it is known as a write- 
enable notch. 

On a 8 inch diskette, information cannot be written onto the 
diskette unless this notch has been covered. On 514 inch 
diskettes, information cannot be written onto the diskette unless 
the notch is left uncovered. 

Some 514 inch diskettes (especially system diskettes) may be 
permanently write protected if their protective envelope does 
not contain a notch. Any 514 inch diskette with a notch can be 
write protected by merely covering the notch with a piece of 
tape as shown in Illustration 5-6. 
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Illustration 5-6. Write Protecting a 514 inch Diskette 




Diskette Handling Rules 

Diskettes are easily damaged. Therefore, certain rules should be 
observed when handling or storing diskettes. 

First of all, keep your diskettes clear of magnetic fields. Most 
devices with electric motors contain magnetic fields as do most 
telephones. Keep your diskettes clear of appliances with electric 
motors and telephones. However, it is safe to place diskettes on 
top of the lie or the Disk II unit. 

When writing on a diskette label, do so only with a felt tip pen. 
Never use a pencil or a ball point pen. Doing so can damage the 
diskette surface. 

Exposure to the sun or to extreme heat can cause diskettes to 
warp. Be certain to keep your diskettes out of direct sunlight and 
away from heat sources. 
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Never touch the actual exposed surface (brown or grey) of the 
diskette. Handle only the diskette's black plastic cover. A 
scratch, fingerprint, dirt, or grease mark can cause a loss of data. 

Inserting and Removing a Diskette 

Before a diskette can be inserted, the drive door must be 
opened. This is accomplished by gently pulling outward on the 
drive door lever. 

The diskette is inserted into the drive with its label facing 
upwards, as shown in Illustration 5-7. Slide the diskette gently 
into the device until it clicks into place and then close the drive 
door. 

To remove a diskette, merely open the drive door and gently pull 
the diskette out of the drive. 



Illustration 5-7. Inserting a Diskette 
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DISK OPERATING SYSTEMS 

An operating system can be defined as a group of programs 
which manage the computer’s operation. A disk operating 
system can be defined as a group of programs that manage the 
transfer of data to and from a storage device such as disk or 
magnetic tape. 

The standard operating system provided with an Apple lie with a 
Disk Drive II is Apple DOS3.3 (referred to simply as DOS). Other 
operating systems such as PASCAL and CP/M are also available 
for the Apple lie. 

Apple’s DOS will be discussed in detail in this chapter. 

DISK II SYSTEM 

The name of the floppy disk drive used by the Apple lie is the 
Disk II. The Disk II system includes the disk drive (see Illustration 
5-8), disk controller card (see Illustration 5-9), a cable used to 
connect the disk controller card to the disk drive (see Illustration 
5-9), a System Master diskette, and a BASICS diskette. 

Installing The Disk II System 

First of all, open the rectangular opening labeled 1 on the rear of 
the lie. Next, insert the free end of the cable connected to the 
Disk II through this opening. 

Locate one of the U-shaped clamps and two jack screws (see 
Illustration 5-10). Find the metal bar on the cable. Open the 
clamp slightly and slide it over the cable and the metal bar. The 
flat side of the clamp should be positioned against the cable. The 
raised side of the clamp should be positioned against the metal 
bar. Feed the cable through rectangular opening #1 until the 
clamp can be placed in the opening. Position the clamp in the 
opening, and install the jack screws into the nuts on the clamp. 
Tighten the screws with a small wrench. (See Illustration 5-11.) 
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Illustration 5-8. Disk II Drive 




Illustration 5-9. Disk Contoller Card and Cable 
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Illustration 5-10. Inserting Clamp over Cable and Metal Flap 




Illustration 5-11. Installing the Clamp on the Rear 
of the Apple lie 
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Next, install the cable from drive 1 to the pins labeled DRIVE 1 on 
the disk drive controller card. (See Illustration 5-12.) 

Be sure to install the disk drive cable into the controller card 
before the card has itself been installed in the Apple lie. Doing 
otherwise could result in damage. 

Also, be certain that the disk cable connector has been properly 
inserted into the pins on the controller card. A faulty connection 
can result in damage. 



Illustration 5-12. Installing the Disk Drive 
Cable to the Disk Controller Card. 
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Once the disk cable connectors have been properly connected 
to the disk controller card, the installation of the Disk II system 
can be completed by merely plugging the controller card into 
slot 6. 

Before installing the disk controller card (or any other card), be 
certain that the power switch at the back of the lie is off. If the 
power is on when a card is installed or removed, damage could 
result to the card, the lie, or to both. 

If you wish to install a second drive, follow the same procedure 
except insert the disk drive cable through opening #2 on the rear 
of the lie, and attach the disk drive cable to the pins labeled 
DRIVE 2 on the disk controller card. 

If you wish to install a third or fourth drive, a second disk 
controller card will have to be installed in slot 4. Insert the drive 
cables through openings 3 and 4 on the lie's rear panel. The 
cable connector for drive 3 should be installed on the pins 
labeled DRIVE 1 on this disk controller card. The cable connector 
for drive 4 should be installed on the pins labeled DRIVE 2 on this 
card. 

If you are installing more than one drive, it is a good idea to label 
your drives so as to prevent possible confusion. Remember that 
DOS must be booted from drive 1. 

BOOTING DOS 

There are several different methods of booting DOS on the 
Apple lie depending upon how your lie system is configured as 
well as from which language DOS is being booted. 

Autostart Boot 

The autostart boot is the easiest method of booting DOS 3.3. 
With the Apple lie powered off, place the System Master 
Diskette in drive 1 and close the drive door. Then, turn the lie's 
power on. The disk will spin for a few seconds and then stop. The 
screen display will resemble that depicted in Illustration 5-13. 
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Booting from Integer or Applesoft BASIC 

The prompt character for Integer BASIC is the greater than sign 
(y). The prompt for Applesoft BASIC is the left bracket (]). The 
same commands can be used to boot DOS from either Integer or 
Applesoft BASIC. This command consists of the letters IN or PR 
followed by the pound sign (#) and the slot number containing 
the controller card (generally (6). The boot command should 
resemble one of the following: 

PR#6 

IN#6 

Once the boot command has been entered, press the return key. 
Again, the drive will spin for several seconds, afterwhich the 
screen display depicted in Illustration 5-13 will appear. 



Illustration 5-13. DOS Start-up Screen Display 'i 
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Booting from the Monitor 

The asterisk (*) is the prompt for the assembly language monitor. 
One method of booting DOS from the monitor is to enter the 
following command and press return. 

* C600G 

This causes DOS to be booted from drive 1 (assuming the disk 
controller card was installed in slot 6.) 
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Another method for booting DOS from the monitor is to enter 
the slot number of the drive to be booted from (generally 6) 
followed by Ctrl-P and Return. 

Restarting DOS 

If the computer is already powered on, and you wish to restart 
the System using DOS, you can do so by as follows: 

1. Insert the DOS diskette in drive 1. 

2. Hold down the Open Apple key simultaneously with Ctrl- 
Reset. Release Ctrl-Reset and then release the Open Apple 
key. 

3. The computer will beep. The drive's in-use light will come on 
and the drive will begin spinning. 

4. When DOS has been loaded, the drive will stop and the DOS 
initial screen display will appear on the screen. 

Booting DOS Conclusion 

Once you have booted DOS, you will still be able to execute 
most of your BASIC commands in the same fashion as if DOS had 
not been booted. A few BASIC commands will have additional 
capabilities under DOS. You will also have the option of 
executing DOS commands. 

This is not the case in other operating systems such as CP/M 
Where DOS commands cannot be entered when BASIC is active 
and vice versa. 

Using 13-Sector Diskettes 

While DOS 3.3 initializes diskettes with 16 sectors per track, the 
earlier verison of DOS (3.21 and 3.2) used diskettes with 13 
sectors. The 13 sector diskettes can be run under DOS 3.3 by 
using the BASICS diskette rather than the System Master in the 
loading process. A prompt will appear instructing you to load 
your 13 sector diskette. Remove the BASICS diskette, insert the 
13 sector diskette, and press return. You can now use the 13 
sector diskette. 

You can also convert 13 sector diskettes to 16 sector by using the 
CONVERT13 program located on the System Master. CON- 
VERTS does not actually change the diskette's format, but 
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instead copies files from the 13-sector diskette onto a 16-sector 
diskette (previously initialized for 16 sectors using I NIT under 
DOS 3.3). 

Upon running the program (by executing RUN CONVERT13), a 
menu will appear on the screen. Option 1 starts the conversion 
process. You will be prompted for the source and destination 
slot and drive numbers as will as the filename. You should then 
insert the diskette per your prompt response and press any key to 
begin. Continue this process until all desired files on the 13 
sector diskette have been transferred. When the process has 
been completed, you can reintialize the old 13 sector diskette 
under DOS 3.3 for use as a 16 sector diskette. 

A copy-protected 13-sector disk can also be used under DOS 3.3 
by performing a two-disk startup. First of all, place the DOS 3.3 
System Master in drive 1, close the drive door, and restart the 
system. Then, enter the following command: 

RUN START13 

The following will appear: 

Slot to boot from (DEFAULT = 6) 

Place the 13-sector diskette in drive 1 and press return if your 
disk controller card was installed in slot 6. Otherwise, enter the 
number of the slot where the controller card was installed. 

Prompts 

Once DOS 3.3 has been loaded, either DOS, Integer BASIC, or 
Applesoft BASIC commands can be entered. The prompt dis- 
played on the screen indicates to the user which commands the 
lie will accept. When the Applesoft prompt ( ] ) is displayed, 
either Applesoft BASIC or DOS commands can be entered. 
When the Integer BASIC prompt is displayed (^ ) , either Integer 
BASIC or DOS commands can be entered. 

DOS does not have its own prompt. You can check whether or 
not DOS has been loaded by entering a DOS command. If the 
command works, DOS has been loaded. If the command does 
not work, DOS has not been loaded with the lie, DOS is loaded 
during start-up. 
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Error Message Format — DOS, Applesoft, Interger 

If an incorrect command is entered, an error message will be 
generated. The format of the error message will indicate 
whether that error was generated by DOS, Integer BASIC, or 
Applesoft BASIC. 

If a question mark precedes the error message, the error was 
generated by Applesoft BASIC as indicated in the following 
example: 



? SYNTAX ERROR -* — Applesoft BASIC 

If three asterisks precede the error message, the error was 
generated by Integer BASIC as shown below: 

*** SYNTAX ERROR-*— Integer Basic 

If no prefix precedes the error message, it was generated by 
DOS. The following error message .would be displayed under 
DOS: 



SYNTAX ERROR-* DOS 

DOS COMMANDS 



In the following sections we will discuss the usage of the various 
Apple DOS commands. These include: 



APPEND 

BLOAD 

BRUN 

BSAVE 

CATALOG 

CLOSE 

DELETE 

EXEC 



I N IT 

LOAD 

LOCK 

MAXFILES 

MON 

NOMON 

OPEN 

POSITION 



READ 

RENAME 

RUN 

SAVE 

UNLOCK 

VERIFY 

WRITE 
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Before discussing the individual commands, we will discuss 
topics related to all of these commands. These topics include: 

Filenames 

Drive Number Specification 
Slot Number Specification 
Volume Specification 



Filenames 

In Apple’s DOS, a file must be referenced using its filename. 

DOS filenames must adhere to certain rules. First of all, a 
filename must be from 1 to 30 characters i n length. Any characters 
in excess of 30 will be dropped (or truncated). The first character 
of the filename must be a letter. Any keyboard character except 
the comma can be used in a filename. 

Control characters can be included in filenames, although they 
will not be displayed in catalog listings as they are nonprinting 
characters. For example, the following filename: 

TEXTf Tindrcates pressing the Control key 

would be displayed as TEXT in the catalog listing. However, if an 
attempt was made to load the file using the filename TEXT, DOS 
would not be able to locate the file. 

Using control characters within filenames offers an effective 
security measure, as others will not be able to identify the actual 
filename. 

Drive Specification 

Generally, DOS commands allow the user to specify several 
optional parameters including the diskette’s volume number, 
the slot containing the disk controller, and the disk drive being 
used. 

Each disk controller can control two separate disk drives. If a disk 
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drive is not specified in a DOS command, that command will 
affect the diskette in drive 1 . In other words, drive 1 is the default 
drive. 

If you wish the command to affect drive 2, end the command 
with a comma followed by D2. The following command would 
result in the directory for the diskette in drive 2 being displayed: 

CATALOG, D2 

Once D2 has been specified, all subsequent DOS commands will 
affect the diskette in drive 2. In other words, drive 2 will now be 
the default drive. 

If you wish to change the drive affectedly DOS commands back 
to drive 1, merely end your DOS command with a comma 
followed by D1. The default drive will then be drive 1. 

Slot Specification 

If you wish to use more than two drives with your lie, an 
additional controller card must be installed in one of the lie's 
expansion slots. Generally, the second controller card is installed 
in slot 4. Again two drives can be connected to this second 
controller card. 

If you wish to reference drives 3 and 4, you must use a second 
parameter known as a slot parameter. You cannot reference 
these drives as D3 and D4. 

The slot parameter follows the DOS command just like the drive 
parameter. The slot parameter must be separated from the DOS 
command or drive parameter with a comma. The slot parameter 
consists of the letter S followed by the slot number containing 
the disk controller to be accessed. 

~v 

The DOS command and any filenames must be specified first in 
the command. However, the order of the parameters (drive slot) 
is not critical. 
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For example, the following DOS command: 

CATALOG,S4,D2 

would acces the second drive installed on the controller card 
installed in slot 4. 

The default slot number will initially be the slot from which DOS 
was booted. Regardless of the slot used to boot DOS, DOS must 
always be booted from drive 1 rather than drive 2. If a slot 
parameter is subsequently executed, the specified slot will be 
the new default. 

When using the slot parameter with DOS commands, be certain 
that the specified slot contains a disk controller card. The follow- 
ing error will appear if the specified slot does not contain a disk 
controller card. 



I/O ERROR 

DOS will then suppose that the specified drive (which is in fact 
not connected to the system) is still running. DOS will wait for 
this non-existent controller and drive to signal that it has stopped 
running. In other words, DOS will be locked up even if the 
correct slot is specified. 

If you do not care to save the program in memory, recovery from 
this error condition can be attained by simply pressing Reset. If 
you wish to save the program in RAM, you can do so by resetting 
the default slot parameter to the correct slot number. You can do 
so by entering: 



CATALOG, Sx 

where x is a valid slot number. 

Volume Specification 

A volume number can be assigned to a diskette when it is 
initialized. The volume number is specified during initialization 




